支持的功能

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

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、1cm）会写入为精确行高。em 和 rem 等与字体相关的单位则保留为文档默认值。

列表

表格

单元格级和行级属性（背景、边框、垂直对齐、行高）需要 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 字段输出。请参见页码字段。

审阅和协作

* 在 preserve 模式下，插入和删除会以建议的形式往返转换。accept 和 reject 会在导入期间直接应用或丢弃它们，因此不会有建议进入文档。编辑器渲染需要修订记录扩展。目前尚未携带某些修订类型，包括导入时的段落拆分、格式变化和移动，以及导出时图片上的格式修订和建议。在这些情况下，内容会进入文档，但变化记录不会保留。请参阅导入修订记录和导出修订记录。

不支持

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