CKEditor 生态系统文档
Search
主页/CKEditor 5/功能

guide从 Word 导入与从 Office 粘贴比较

除了从 Word 导入，还有一个更简单的 从 Office 粘贴 插件，它允许您将内容从 Microsoft Word 粘贴到 CKEditor 5 WYSIWYG 编辑器中，同时保留其原始结构和格式。但是，这两种解决方案在很多方面有所不同。

# 从 Office 粘贴

从 Office 粘贴 和 从 Office 粘贴增强 功能允许您将内容从 Microsoft Word 粘贴到 CKEditor 5 WYSIWYG 编辑器中，并保持原始结构和格式。在 Microsoft Word 中创建文档后，您可以将其复制到 CKEditor 5 并保留基本文本样式、标题级别、链接、列表、表格和图像 - 只要这些功能本身受编辑器支持。

  • 适用于小型文档以及仅选择和复制文档部分的用例。
  • 依赖于操作系统剪贴板 HTML，这限制了支持的功能数量。
  • 保留手动选择和复制的原始 DOCX 格式。
  • 简单、直观，但无法通过 REST API 自动化许多 Word 文档的迁移过程。

此操作快速简便，但只能手动执行。

# 从 Word 导入

从 Word 导入服务可以自动执行，不需要 WYSIWYG 编辑器，也不需要人工监督来转换文件。与从 Office 粘贴相比，导入可以处理任何 内容格式，并且不受编辑器支持的功能限制。

  • 允许将大型文档转换为可以轻松导入 CKEditor 5 和其他工具的 HTML。
  • 直接在 XML 上运行，其中包含有关文档和 Word 实例设置的更多信息。
  • 作为 CKEditor 5 插件和 REST API 可用，用于直接的服务器到服务器转换。
  • 既作为 SaaS 服务，也作为本地解决方案可用。
  • 适用于通过 REST API 服务将整个 Word 文档数据库迁移到 HTML。
  • 非常适合需要在浏览器中编辑或显示的更高级的文档。
  • 开箱即用地支持协作功能，如跟踪更改和评论。

# 功能比较

以下表格比较了从 Office 粘贴和从 Office 粘贴增强 CKEditor 5 插件以及从 Word 导入功能的功能。有关从 Word 导入功能的更详细概述，请参阅 内容格式 指南。

# 协作功能

功能名称                                                     粘贴 增强 导入
评论 ❌ ❌ ✅
评论存档 ❌ ❌ ✅
评论 - 图像 ❌ ❌ ✅
评论 - 表格单元格 ❌ ❌ ✅
跟踪更改 - 文本插入 ❌ ❌ ✅
跟踪更改 - 文本删除 ❌ ❌ ✅
跟踪更改 - 移动文本 ❌ ❌ ✅
跟踪更改 - 图片 ❌ ❌ ✅
跟踪更改 - 表格 ❌ ❌ ⚠
跟踪更改 - 表格文本 ❌ ❌ ✅
跟踪更改 - 表格行 ❌ ❌ ⚠
跟踪更改 - 表格单元格 ❌ ❌ ⚠
跟踪更改 - 列表 ❌ ❌ ⚠
跟踪更改 - 列表文本 ❌ ❌ ✅
跟踪更改 - 列表项 ❌ ❌ ⚠
跟踪更改 - 文本格式 ❌ ❌ ⚠

⚠ 导入：对于不支持的功能的跟踪更改将保留作者建议的原始内容。但是，它们不会被识别为正确的跟踪更改建议。例如，如果用户使用跟踪更改添加表格，该表格将以 HTML 格式输出，但不会被标记为建议。此限制将很快通过即将发布的“从 Word 导入”版本解决。

# 行内格式

功能名称                                                     粘贴 增强 导入
字体颜色 ✅ ✅ ✅
字体背景 ✅ ✅ ✅
字体大小 ✅ ✅ ✅
字体系列 ✅ ✅ ✅
粗体 ✅ ✅ ✅
斜体 ✅ ✅ ✅
下划线 ✅ ✅ ✅
自定义下划线 ❌ ⚠️ ✅
删除线 ✅ ✅ ✅
下标 ✅ ✅ ✅
上标 ✅ ✅ ✅
链接 ✅ ✅ ✅
软换行 ✅ ✅ ✅
小型大写字母 ❌ ✅ ✅
全部大写字母 ❌ ✅ ✅
字母间距 ⚠️ ✅ ✅
字体拉伸 ❌ ✅ ✅
隐藏文本 ⚠️ ⚠️ ✅
  • ⚠️ 粘贴：字母间距和隐藏文本仅在启用 通用 HTML 支持 功能时才受支持。
  • ⚠️ 粘贴增强：高级下划线粘贴为普通下划线。
  • ⚠️ 粘贴增强：隐藏文本仅在启用 通用 HTML 支持 功能时才受支持。

# 段落

功能名称                                                     粘贴 增强 导入
文本对齐 ✅ ✅ ✅
缩进 ✅ ✅ ✅
首行缩进 ⚠️ ⚠️ ✅
悬挂缩进 ⚠️ ⚠️ ✅
行高 ⚠️ ⚠️ ✅
段落间距 ⚠️ ⚠️ ✅
段落边框 ⚠️ ⚠️ ✅
背景颜色 ⚠️ ⚠️ ✅
  • ⚠️ 首行缩进、悬挂缩进、行高、段落间距和段落边框仅在启用 通用 HTML 支持 功能时才受支持。

# 标题

功能名称                                                     粘贴 增强 导入
内置标题样式 ✅ ✅ ✅
保留标题格式 ❌ ✅ ✅
自定义大纲级别 ❌ ✅ ✅

# 列表

功能名称                                                     粘贴 增强 导入
有序列表 ✅ ✅ ✅
无序列表 ✅ ✅ ✅
自定义列表标记 ❌ ️❌ ❌
特定语言的有序列表标记 ❌ ❌ ✅
自定义起始编号 ✅ ✅ ✅
中间的起始编号不同 ❌ ❌ ✅
多级列表 ❌ ❌ ⚠️
  • ⚠️ 导入：现在支持使用 X 级制表符偏移的多级列表。请注意，目前不支持从上一级延续标记（例如，2.1、2.2）。

# 表格

功能名称                                                     粘贴 增强 导入
表格宽度 ✅ ✅ ✅
单元格/列宽 ✅ ✅ ✅
单元格/行高 ✅ ✅ ✅
单元格合并 ✅ ✅ ✅
单元格填充 ✅ ✅ ✅
单元格间距 ✅ ✅ ✅
单元格水平对齐 ✅ ✅ ✅
单元格垂直对齐 ✅ ✅ ✅
表格背景颜色 ✅ ✅ ✅
单元格背景颜色 ✅ ✅ ✅
表格边框样式 ✅ ✅ ✅
表格边框颜色 ✅ ✅ ✅
单元格边框样式 ✅ ✅ ✅
单元格边框颜色 ✅ ✅ ✅
表格标题 ✅ ✅ ✅
嵌套表格 ✅ ✅ ✅
表格对齐/浮动 ✅ ✅ ✅
表格标题 ⚠️ ⚠️ ⚠️
  • ⚠️ 表格标题转换为格式化的（仅导入）段落。

# 图片

功能名称                                                     粘贴 增强 导入
嵌入式图片 ✅ ✅ ✅
外部链接图片 ✅ ✅ ✅
图片链接 ✅ ✅ ✅
图片替换文本 ✅ ✅ ✅
图片高度 ✅ ✅ ✅
图片宽度 ✅ ✅ ✅
图片对齐 ✅ ✅ ✅
绝对定位的图片 ⚠️ ⚠️ ⚠️
图片标题 ⚠️ ⚠️ ⚠️
  • ⚠️ 绝对定位的图片将保留，但其原始位置会丢失。
  • ⚠️ 图片标题转换为格式化的（仅导入）段落。

# 分页符

功能名称                                                     粘贴 增强 导入
普通分页符 ✅ ✅ ✅
分页符之前样式 ❌ ❌ ✅

# 水平线

功能名称                                                     粘贴 增强 导入
水平线 ✅ ✅ ✅

# Word 样式

功能名称                                                     粘贴 增强 导入
内置样式 ❌ ⚠️ ✅
格式样式 ❌ ⚠️ ✅
字体样式 ❌ ⚠️ ✅
段落样式 ❌ ⚠️ ✅
边框样式 ❌ ⚠️ ✅
编号样式 ✅ ✅ ✅

# 默认样式

默认样式需要为 CKEditor 5 从 Word 导入插件和 REST API 启用 config.default_styles 配置选项。

功能名称                                                     粘贴 增强 导入
格式样式 ⚠️ ✅ ✅
字体样式 ⚠️ ✅ ✅
段落样式 ⚠️ ✅ ✅
  • ⚠️ 粘贴：默认文档样式部分受支持，但不能有意禁用或启用。

# 节

功能名称                                                     粘贴 增强 导入
文档边距 ❌ ✅ ✅
文档大小 ❌ ✅ ✅
多节文档 ❌ ❌ ❌
节栏 ❌ ❌ ❌
页眉和页脚 ❌ ❌ ❌
  • ⚠️ 导入：目前不支持多节文档和节栏。

# 复杂对象

功能名称                                                     粘贴 增强 导入
目录 ⚠️ ✅ ✅
表单对象 ⚠️ ⚠️ ⚠️
  • ⚠️ 粘贴：仅保留目录文本，但结构和样式会丢失。
  • ⚠️ 表单对象：仅保留文本和样式。

# 技术细节

为了更好地理解这两种产品的区别，了解这两种功能在技术层面的工作方式是值得的。在从 Office 粘贴中，编辑器使用操作系统的剪贴板，在从文档中复制时，剪贴板会用 Microsoft Word 内容（以 HTML 格式）填充。此 HTML 由 Word 应用程序本身提供，并包含文档的基本格式。当用户从 Word 文档中粘贴内容时，CKEditor 5 会清理此 HTML 并使其在语义上正确，以便编辑器可以解析它。但是，此操作存在局限性，因为 CKEditor 5 只能理解从剪贴板获取的尽可能多的内容，并且完全依赖于 Microsoft Word 应用程序的剪贴板实现。

从 Word 导入功能没有此限制。因为它可以直接访问文档，所以它可以从文档中检索尽可能多的信息，就像 Word 一样。因此，可以支持诸如协作功能、文档设置等内容，而这些内容仅在操作剪贴板内容时才不可用。我们不再受 Microsoft Word 应用程序的限制，因此，从 Word 导入生成的 HTML 比从 Word 粘贴更高级。

# 需要 GHS 的 CSS 属性列表

这是 从 Word 导入 功能正确转换但默认情况下在 CKEditor 5 中不起作用的所有 CSS 属性的列表，需要 通用 HTML 支持 (GHS) 功能。

# 段落

# HTML 元素

  • p

# CSS 属性

  • background-color
  • line-height
  • border-top
  • border-bottom
  • border-left
  • border-right
  • margin-top
  • margin-bottom
  • text-indent

# 标题

# HTML 元素

  • h1
  • h2
  • h3
  • h4
  • h5
  • h6

# CSS 属性

  • font-weight
  • font-size

标题也需要段落的所有 CSS 属性。

# 列表

# HTML 元素

  • ul
  • ol

# CSS 属性

  • list-style-type
  • margin-top
  • margin-bottom

# 列表项

# HTML 元素

  • li

# CSS 属性

  • list-style-type

# 跨度

# HTML 元素

  • span

# CSS 属性

  • letter-spacing
  • text-transform
  • font-variant-caps
  • font-stretch

# 下划线

# HTML 元素

  • u

# CSS 属性

  • text-decoration-line
  • text-decoration-style
  • text-decoration-thickness
  • text-decoration-color
  • text-decoration-skip-ink

# 图片

# HTML 元素

  • img

# CSS 属性

  • position
  • display
  • float
  • margin-top
  • margin-left
  • margin-right
  • transform
  • z-index

# 图表

# HTML 元素

  • figure

# CSS 属性

  • margin-top
  • margin-bottom
  • margin-left
  • margin-right

# 表格

# HTML 元素

  • table

# CSS 属性

  • border-collapse
  • border-spacing

# 表格单元格

# HTML 元素

  • td
  • th

# CSS 属性

  • vertical-align

# 表格标题单元格

# HTML 元素

  • th

# CSS 属性

  • font-weight
  • text-align