支持的功能

下表展示了每种文档功能在转换流水线的三个阶段中的表现：

1. 导入 将 DOCX 内容转换为 Tiptap JSON。
2. 编辑器 在浏览器中渲染该 JSON。每种节点和标记类型都需要匹配的 Tiptap 扩展才能正确显示。
3. 导出 将编辑器内容转换回 DOCX 文件。

某项功能可能在某个阶段受支持，但在另一个阶段不受支持。例如，制表符会被导入并在编辑器中渲染，但导出扩展目前还不会将其写回 DOCX。

导入和导出各自都有两种集成路径：一种是 编辑器扩展，另一种是 REST API。对于大多数功能，这两种路径会产生相同的结果。对于存在差异的地方（脚注、页眉/页脚、导出自定义），相关安装页面会说明具体细节。

其他格式

这些表格专门描述 DOCX 流水线，因为 DOCX 是所有其他导出所基于的参考格式。PDF、ODT、EPUB 和 DOC 都是先生成一个 DOCX 文件，然后通过云服务将其转换为目标格式。凡是在 DOCX 导出中可用的功能，通常也会延续到其他格式，不过每种格式都可能引入自己的限制。详情请参见相应格式页面。

Markdown 走的是完全独立的转换路径，并支持另一组功能。相关内容记录在其单独的页面中。

行内格式

块级元素

文本和段落样式

导入服务会从 DOCX 源中提取段落级样式属性，例如间距、缩进和行高。ConvertKit 的自定义 Paragraph 和 Heading 会自动渲染这些样式。对于文档命名样式目录（Heading 1、Normal、Quote 等）中的排版样式，请使用实验性的 CSS 注入 功能，它会将样式目录提取为带作用域的 CSS 规则。

* 字间距会作为 textStyle.letterSpacing 提取，但没有任何内置扩展会渲染它。若要渲染导入的字间距，请 扩展 TextStyle。
** 默认不会应用 Word 的命名样式排版。请使用 CSS 注入 将其提取为带作用域的 CSS。
*** 导出时只有比例行距可以往返保留：无单位倍数（如 1.5）或百分比（如 150%）。带单位的固定行高（例如 24px、18pt）没有对应的比例 DOCX 表达，因而不会被保留。

列表

表格

单元格级和行级属性（背景、边框、垂直对齐、行高）需要 ConvertKit 的 ConvertTableKit，该套件默认包含。若使用独立的 @tiptap/extension-table，这些属性仍会被提取到 JSON 中，但会被编辑器的 schema 丢弃。若要通过 Pages 扩展 实现分页布局，请改用 PagesTableKit；其表格扩展在内部继承了 ConvertKit 的扩展，因此相同的 DOCX 单元格属性也会继续传递。有关具体组成，请参见 表格内容参考。

媒体

* ConvertKit 的自定义 Image 会声明 cropTop/cropBottom/cropLeft/cropRight，并将它们作为 data-crop-* 属性输出。若要实现视觉裁剪，请添加 CSS，将这些数据属性转换为 clip-path 或 object-position。

页面布局

* 导入行为在不同集成路径中有所不同。REST API 会在响应中将脚注、尾注以及页眉/页脚作为单独字段返回。编辑器扩展 会通过 Pages 扩展自动应用页眉和页脚，但不会显示脚注或尾注数据。详情请参见安装页面。
** 页眉/页脚中的 Word PAGE 和 NUMPAGES 字段会转换为规范文本标记（{page} / {numpages}）：在使用 Pages 扩展时默认开启；在其他情况下可通过 placeholders 字段选择启用。其他字段代码（DATE、AUTHOR、MERGEFIELD）仍会按其缓存的显示值导入。导出时，编辑器扩展 和 REST API 都会将页眉/页脚内容中的 {page} / {total} 标记作为实时的 PAGE / NUMPAGES 字段输出。请参见页码字段。

不支持

这些功能在导入期间不会被转换，或者仅有限转换。