--- title: "支持的功能" description: "查看在 Tiptap 转换流水线中，哪些文档功能支持导入、编辑器渲染和导出。" canonical_url: "https://tiptap.zhcndoc.com/conversion/getting-started/feature-support-matrix" --- # 支持的功能 查看在 Tiptap 转换流水线中，哪些文档功能支持导入、编辑器渲染和导出。 下表展示了每种文档功能在转换流水线的三个阶段中的表现： 1. **导入** 将 DOCX 内容转换为 Tiptap JSON。 2. **编辑器** 在浏览器中渲染该 JSON。每种节点和标记类型都需要匹配的 Tiptap 扩展才能正确显示。 3. **导出** 将编辑器内容转换回 DOCX 文件。 某项功能可能在某个阶段受支持，但在另一个阶段不受支持。例如，制表符会被导入并在编辑器中渲染，但导出扩展目前还不会将其写回 DOCX。 导入和导出各自都有两种集成路径：一种是 [编辑器扩展](https://tiptap.zhcndoc.com/conversion/import/docx/editor-extension.md)，另一种是 [REST API](https://tiptap.zhcndoc.com/conversion/import/docx/rest-api.md)。对于大多数功能，这两种路径会产生相同的结果。对于存在差异的地方（脚注、页眉/页脚、导出自定义），相关安装页面会说明具体细节。 > **编辑器列默认假设使用 ConvertKit:** > > 下表中的编辑器列默认假设推荐配置：已安装 [ConvertKit](https://tiptap.zhcndoc.com/conversion/import/docx/convertkit.md) 作为编辑器的扩展套件。ConvertKit 是基础功能的超集（相当于 StarterKit 的节点，加上针对 Paragraph、Heading、Image 以及表格栈的 DOCX 感知覆盖）。如果没有 ConvertKit，段落间距和缩进、图片裁剪以及表格单元格格式仍会被提取到 JSON 中，但会被编辑器的 schema 丢弃。若编辑器支持取决于其他因素（Pages、某个自定义扩展），该行会注明依赖项。 ## 其他格式 这些表格专门描述 DOCX 流水线，因为 DOCX 是所有其他导出所基于的参考格式。[PDF](https://tiptap.zhcndoc.com/conversion/export/pdf/editor-extension.md)、[ODT](https://tiptap.zhcndoc.com/conversion/export/odt/editor-extension.md)、[EPUB](https://tiptap.zhcndoc.com/conversion/export/epub/editor-extension.md) 和 [DOC](https://tiptap.zhcndoc.com/conversion/export/doc/editor-extension.md) 都是先生成一个 DOCX 文件，然后通过云服务将其转换为目标格式。凡是在 DOCX 导出中可用的功能，通常也会延续到其他格式，不过每种格式都可能引入自己的限制。详情请参见相应格式页面。 [Markdown](https://tiptap.zhcndoc.com/conversion/export/markdown/editor-extension.md) 走的是完全独立的转换路径，并支持另一组功能。相关内容记录在其单独的页面中。 ## 行内格式 | 功能 | 导入 | 编辑器 | 导出 | | -------------------------------------------------------------------------------------------------------------- | -- | --- | -- | | [粗体](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/bold-italic-underline-strike.md) | ✓ | ✓ | ✓ | | [斜体](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/bold-italic-underline-strike.md) | ✓ | ✓ | ✓ | | [下划线](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/bold-italic-underline-strike.md) | ✓ | ✓ | ✓ | | [删除线](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/bold-italic-underline-strike.md) | ✓ | ✓ | ✓ | | [下标](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/subscript-superscript.md) | ✓ | ✓ | ✓ | | [上标](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/subscript-superscript.md) | ✓ | ✓ | ✓ | | 行内代码 | ✓ | ✓ | ✓ | | [文本颜色](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/text-color-highlight.md) | ✓ | ✓ | ✓ | | [高亮](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/text-color-highlight.md) | ✓ | ✓ | ✓ | | [字体族](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/font-family-size.md) | ✓ | ✓ | ✓ | | [字号](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/font-family-size.md) | ✓ | ✓ | ✓ | | [超链接](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/hyperlinks-bookmarks.md) | ✓ | ✓ | ✓ | | [制表符](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/tabs.md) | \~ | \~ | ✕ | | [内部书签](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/hyperlinks-bookmarks.md) | \~ | \~ | ✕ | ## 块级元素 | 功能 | 导入 | 编辑器 | 导出 | | -------------------------------------------------------------------------------------------------- | -- | --- | -- | | [段落](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/paragraphs.md) | ✓ | ✓ | ✓ | | [标题 1 到 6](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/headings.md) | ✓ | ✓ | ✓ | | [引用块](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/block-elements.md) | ✓ | ✓ | ✓ | | [代码块](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/block-elements.md) | ✕ | ✓ | ✕ | | [水平线](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/block-elements.md) | ✓ | ✓ | ✓ | | [手动换行](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/block-elements.md) | ✓ | ✓ | ✓ | ## 文本和段落样式 导入服务会从 DOCX 源中提取段落级样式属性，例如间距、缩进和行高。ConvertKit 的自定义 Paragraph 和 Heading 会自动渲染这些样式。对于文档命名样式目录（Heading 1、Normal、Quote 等）中的排版样式，请使用实验性的 [CSS 注入](https://tiptap.zhcndoc.com/conversion/import/docx/css-injection.md) 功能，它会将样式目录提取为带作用域的 CSS 规则。 | 功能 | 导入 | 编辑器 | 导出 | | -------------------------------------------------------------------------------------------------- | -- | ------ | ------- | | [文本对齐](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/text-alignment.md) | ✓ | ✓ | ✓ | | [行距](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/paragraphs.md) | ✓ | ✓ | ✓\*\*\* | | [段落间距](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/paragraphs.md) | ✓ | ✓ | ✓ | | [缩进](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/paragraphs.md) | ✓ | ✓ | ✓ | | [字间距](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/font-family-size.md) | ✓ | ✕\* | ✕ | | [段落边框](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/paragraphs.md) | ✕ | ✕ | ✕ | | [Word 样式](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/word-styles.md) | \~ | \~\*\* | \~ | **\*** 字间距会作为 `textStyle.letterSpacing` 提取，但没有任何内置扩展会渲染它。若要渲染导入的字间距，请 [扩展 TextStyle](https://tiptap.zhcndoc.com/conversion/getting-started/guides/styling-converted-content.md#extending-extensions-for-unsupported-attributes)。 **\*\*** 默认不会应用 Word 的命名样式排版。请使用 [CSS 注入](https://tiptap.zhcndoc.com/conversion/import/docx/css-injection.md) 将其提取为带作用域的 CSS。 **\*\*\*** 导出时只有比例行距可以往返保留：无单位倍数（如 `1.5`）或百分比（如 `150%`）。带单位的固定行高（例如 `24px`、`18pt`）没有对应的比例 DOCX 表达，因而不会被保留。 ## 列表 | 功能 | 导入 | 编辑器 | 导出 | | -------------------------------------------------------------------------------------------- | -- | --- | -- | | [项目符号列表](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/lists.md) | ✓ | ✓ | ✓ | | [有序列表](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/lists.md) | ✓ | ✓ | ✓ | | [有序列表编号格式](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/lists.md) | \~ | ✓ | ✕ | | [嵌套列表](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/lists.md) | ✓ | ✓ | ✓ | | [任务列表](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/lists.md) | ✕ | ✓ | ✕ | ## 表格 单元格级和行级属性（背景、边框、垂直对齐、行高）需要 ConvertKit 的 `ConvertTableKit`，该套件默认包含。若使用独立的 `@tiptap/extension-table`，这些属性仍会被提取到 JSON 中，但会被编辑器的 schema 丢弃。若要通过 [Pages 扩展](https://tiptap.zhcndoc.com/pages/getting-started/overview.md) 实现分页布局，请改用 [PagesTableKit](https://tiptap.zhcndoc.com/pages/guides/pages-tablekit.md)；其表格扩展在内部继承了 ConvertKit 的扩展，因此相同的 DOCX 单元格属性也会继续传递。有关具体组成，请参见 [表格内容参考](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md)。 | 功能 | 导入 | 编辑器 | 导出 | | ---------------------------------------------------------------------------------------------------- | -- | --- | -- | | [基础表格](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✓ | | [合并单元格（colspan）](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✓ | | [合并单元格（rowspan）](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✓ | | [表头行](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✕ | | [列宽](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✓ | | [单元格背景](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✕ | | [单元格边框](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✕ | | [单元格垂直对齐](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✕ | | [行高](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/tables.md) | ✓ | ✓ | ✕ | ## 媒体 | 功能 | 导入 | 编辑器 | 导出 | | --------------------------------------------------------------------------------------------------- | -- | ---- | -- | | [行内图片](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/images.md) | ✓ | ✓ | ✓ | | [浮动图片](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/images.md) | \~ | ✕ | ✕ | | [图片尺寸](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/images.md) | ✓ | ✓ | ✓ | | [图片裁剪](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/images.md) | ✓ | \~\* | ✕ | | [数学和公式](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/math-equations.md) | ✕ | ✓ | ✓ | **\*** ConvertKit 的自定义 Image 会声明 `cropTop`/`cropBottom`/`cropLeft`/`cropRight`，并将它们作为 `data-crop-*` 属性输出。若要实现视觉裁剪，请添加 CSS，将这些数据属性转换为 `clip-path` 或 `object-position`。 ## 页面布局 | 功能 | 导入 | 编辑器 | 导出 | | ---------------------------------------------------------------------------------------------------- | ------ | --- | ------ | | [分页符](https://tiptap.zhcndoc.com/conversion/content-types/page-layout/page-breaks.md) | ✓ | \~ | ✓ | | [页眉和页脚](https://tiptap.zhcndoc.com/conversion/content-types/page-layout/headers-footers.md) | ✓\* | ✓ | ✓ | | [节](https://tiptap.zhcndoc.com/conversion/content-types/page-layout/page-structure.md) | \~ | ✕ | ✕ | | [页面大小和边距](https://tiptap.zhcndoc.com/conversion/content-types/page-layout/page-structure.md) | ✕ | ✓ | ✓ | | [页码](https://tiptap.zhcndoc.com/conversion/content-types/page-layout/page-structure.md) | \~\*\* | ✓ | \~\*\* | | [脚注](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/footnotes-endnotes.md) | ✓\* | ✕ | ✕ | | [尾注](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/footnotes-endnotes.md) | ✓\* | ✕ | ✕ | | [评论](https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/comments.md) | ✓ | ✓ | ✓ | **\*** 导入行为在不同集成路径中有所不同。[REST API](https://tiptap.zhcndoc.com/conversion/import/docx/rest-api.md) 会在响应中将脚注、尾注以及页眉/页脚作为单独字段返回。[编辑器扩展](https://tiptap.zhcndoc.com/conversion/import/docx/editor-extension.md) 会通过 Pages 扩展自动应用页眉和页脚，但不会显示脚注或尾注数据。详情请参见安装页面。 **\*\*** 页眉/页脚中的 Word `PAGE` 和 `NUMPAGES` 字段会转换为规范文本标记（`{page}` / `{numpages}`）：在使用 Pages 扩展时默认开启；在其他情况下可通过 `placeholders` 字段选择启用。其他字段代码（`DATE`、`AUTHOR`、`MERGEFIELD`）仍会按其缓存的显示值导入。导出时，**编辑器扩展** 和 **REST API** 都会将页眉/页脚内容中的 `{page}` / `{total}` 标记作为实时的 `PAGE` / `NUMPAGES` 字段输出。请参见[页码字段](https://tiptap.zhcndoc.com/conversion/content-types/page-layout/page-structure.md#page-numbers)。 > **页面布局需要 Pages 扩展:** > > 页眉、页脚、分页符以及分页布局都需要 [Pages 扩展](https://tiptap.zhcndoc.com/pages/getting-started/overview.md) 才能在编辑器中渲染。没有它，即使转换服务生成了这些内容，也没有地方可供显示。 ## 不支持 这些功能在导入期间不会被转换，或者仅有限转换。 | 功能 | 状态 | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 修订和修订记录 | 不会转换。跟踪修订扩展存在，但未与转换连接。 | | 目录 | 作为 `tableOfContents` 节点导入（标题和标题范围）。需要一个[自定义扩展](https://tiptap.zhcndoc.com/editor/extensions/custom-extensions/extend-existing.md)来在编辑器中渲染它。现有的[目录扩展](https://tiptap.zhcndoc.com/editor/extensions/functionality/table-of-contents.md)是一个用于构建侧边栏导航的无头工具，而不是文档块渲染器。不导出。 | | 文本框 | 不会转换。文本框中的内容不会被提取。 | | 形状、SmartArt、WordArt | 不会转换。这些元素在导入期间不会被提取。 | | 域代码（DATE、AUTHOR、MERGEFIELD） | 缓存的显示值会以纯文本形式保留（例如，显示为“2026年4月10日”的 DATE 域会作为文本“2026年4月10日”导入）。域代码本身不会转换，因此该值会变为静态且不会更新。 | | 页码域代码（PAGE、NUMPAGES） | 当启用 `placeholders` 时，会翻译为规范文本标记（`PAGE` 对应 `{page}`，`NUMPAGES` 对应 `{numpages}`）（Pages 扩展默认启用；也可通过 REST API 的 `placeholders={}` 表单字段显式启用）。Pages 扩展可原生渲染 `{page}`；通过 `Pages.configure({ placeholders: { total: 'numpages' } })` 将 `{numpages}` 映射后即可动态渲染。若 `placeholders: false`（或在 REST API 中省略），缓存的显示值会作为纯文本导入。 | | 文档元数据（作者、标题、关键词） | 不会转换。元数据不包含在 JSON 输出中。 | | 表单域和内容控件 | 不会转换。内联结构化文档标记（SDT）的文本内容会保留，但控件元数据会被丢弃。 | | 隐藏文本 | 标记为隐藏的文本运行（`w:vanish`）会从导入输出中排除。 | | 从右到左的文本方向 | 导入时不会解析 DOCX ``（段落方向）和 ``（文本运行方向），导出时也不会写入。用阿拉伯语、希伯来语、波斯语、乌尔都语及其他 RTL 语言编写的文档会按编辑器的 CSS 方向渲染（默认 LTR）。请在编辑器根元素上设置 `dir="rtl"`，或在应用层检测语言以处理此类情况。详见[文本对齐](https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/text-alignment.md)。 |