块级元素

Beta

块级元素定义文档的结构布局:引用段落、预格式化代码、视觉分隔线和换行。所有这些都包含在 StarterKit 中。不同环节的支持情况各不相同。

你需要什么

  • 扩展: StarterKit(包含 BlockquoteCodeBlockHorizontalRuleHardBreak
  • 配置: 无需配置。分页符需要单独的扩展,并在其单独页面中介绍。
  • 集成路径: 通过编辑器扩展REST API 导入与导出的工作方式完全相同。

支持概览

导入编辑器导出
引用段落支持支持(StarterKit)支持
代码块不支持支持(StarterKit)不支持(会被丢弃)
水平分隔线支持支持(StarterKit)支持
硬换行支持支持(StarterKit)支持
分页符分页符

引用段落

在 Word 中,引用段落是使用“Quote”样式的段落(大小写不敏感匹配)。

导入时会生成一个 blockquote 节点,包裹一个或多个 paragraph 子节点。引号内的行内格式会被保留。

导出时会将使用“Quote”样式的段落写回 DOCX。引用段落可正确往返转换。

扩展: Blockquote(StarterKit) | 快捷键: Cmd+Shift+B

代码块

DOCX 导入不会将任何 Word 样式映射为 codeBlock 节点。代码块可通过 StarterKit 在编辑器中使用,但在转换流程中不支持导入或导出。

代码块不支持 DOCX 转换

代码块既不会从 DOCX 导入,也不会导出到 DOCX。导出时,codeBlock 节点不会被转换。如果你的工作流需要代码块的往返转换,请在导入和导出扩展上都注册自定义节点处理器。

扩展: CodeBlock(StarterKit) | 快捷键: Cmd+Alt+C

水平分隔线

Word 中的水平分隔线通常是 VML 形状(带有 o:hr 属性的 v:rect,以及 v:line 元素)。导入会检测这些内容并创建 horizontalRule 节点。

导出会使用 VML 形状生成有效的 Word 水平分隔线。水平分隔线可正确往返转换。

扩展: HorizontalRule(StarterKit) | 输入规则: ---___***

硬换行

硬换行(Shift+Enter)会在同一段落内创建新的一行。在 Word 中这对应一个 <w:br/> 元素。硬换行可正确往返转换。

扩展: HardBreak(StarterKit) | 快捷键: Shift+Enter

分页符

分页符已移至页面布局下的分页符页面。

导出

元素DOCX 输出
引用段落带有“Quote”样式的段落
代码块不导出
水平分隔线VML 水平分隔线形状
硬换行文本运行中的 <w:br/>
分页符分页符