Word to Confluence Markdown：将文档导入您的团队 Wiki

Confluence 是使用最广泛的团队 wiki 之一，许多组织都有属于 Confluence 的 Word 文档库。干净地转换这些文档比看起来更棘手——Confluence 的 Markdown 支持有一些怪癖。本指南向您展示最可靠的 Word 到 Confluence 工作流程。

Confluence 支持 Markdown 吗？

Confluence 有部分 Markdown 支持，但它依赖于实现：

• Confluence 云 支持 Markdown 宏，可以在某些上下文中渲染 Markdown，但本机编辑器是它自己的格式
• Confluence 数据中心/服务器 还有一个 Markdown 宏
• Atlassian Rovo / 新编辑器 — 新版本改进了 Markdown 粘贴支持

所有版本中最可靠的方法是将 Word 转换为 Markdown WordToMD，然后使用 Confluence 的 Markdown 导入功能粘贴 Markdown 内容。

方法 1：通过 Confluence 编辑器粘贴 Markdown

步骤

1. 将您的 Word 文档转换为 WordToMD 并点击“复制 Markdown”
2. 在 Confluence 中，打开页面编辑器 文件资源管理器中的
3. 从“插入”菜单（+ 图标）中，选择“标记”或“其他宏 → 标记”
4. 选择“Markdown”作为语言
5. 粘贴 Markdown 内容
6. 单击“插入”

Markup/Markdown 宏将内容呈现为页面内的富文本。它不会转换为原生 Confluence 块，但可以正确呈现标题、表格和列表。

方法2：Word文件导入

Confluence Cloud 具有 Word 导入功能：

1. 创建一个新的 Confluence 页面
2. 单击...菜单 → 导入 Word 文档
3. 选择您的 .docx 文件

这适用于简单文档，但往往会丢失复杂的格式。Markdown 路线提供了更多控制。

方法 3：转换为 HTML

一些团队更喜欢 HTML 作为中间格式，因为 Confluence 的编辑器接受 HTML 粘贴：

1. 将您的 Word 文档转换为 Markdown WordToMD
2. 使用在线工具或将 Markdown 转换为 HTML marked library
3. 切换到 Confluence 源编辑器（Ctrl+Shift+D 或从工具栏）
4. 粘贴 HTML

此方法保留了更复杂的格式，但步骤更多。

格式兼容性

处理台

字表通过以下方式转换为 GFM 管道语法 WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

对于更复杂的表操作，请参阅 Markdown 表：完整指南.

Confluence 中的代码块

Confluence 有自己的代码块宏，提供语法突出显示和行号。导入 Markdown 内容后，您可能需要将 Markdown 宏中的代码块替换为本机 Confluence 代码块宏，以获得更好的可读性：

1. 编辑页面
2. 查找代码部分
3. 插入代码块宏
4. 设置语法突出显示的语言
5. 粘贴代码

参考： Markdown 代码块指南 为标准语法。

Atlassian Confluence 和 ADF

Confluence Cloud 原生使用 Atlassian 文档格式 (ADF) — 丰富内容的 JSON 模式。Markdown 宏位于此之上。对于编程导入，Confluence REST API 直接接受 ADF。如果您正在构建自动化管道，请使用可用的库转换 Word → Markdown → ADF。

对于大多数团队来说，手动工作流程更简单、更快。

迁移文档库

如果您要将数十个 Word 文档迁移到 Confluence：

1. 使用转换所有文件 WordToMD （或批次 Pandoc 适用于大容量）
2. 创建 Confluence 空间并规划页面层次结构
3. 按部分导入页面，将相关文档分组到父页面下
4. 导入后添加 Confluence 特定功能：标签、页面限制、@mentions

FAQ

我可以在没有宏的情况下在 Confluence 中本地使用 Markdown 吗？ 在带有新编辑器的 Confluence Cloud 的某些配置中，您可以键入 Markdown 快捷方式，它们会自动转换（例如，键入 ## 创建一个 H2)。但对于粘贴转换后的文档，Markdown 宏更可靠。

我的标题格式在导入后丢失 - 一切看起来都像正文。 这通常意味着 Markdown 宏未激活。Markdown 必须位于 Markup/Markdown 宏块内，而不是作为纯文本粘贴到标准编辑器中。

表显示为原始管道字符。 同样的问题 - 内容必须位于 Markdown 宏内，而不是在标准文本编辑器中。

是否有一种自动方法将 Word 文档同步到 Confluence 页面？ 是的 - Confluence 的“外部文档”功能、滚动版本或使用 Confluence REST API 的自定义脚本等工具可以自动将 Markdown 文件同步到页面。

结论

最干净的 Word 到 Confluence 工作流程是：转换为 WordToMD，然后通过 Markdown 宏导入。对于复杂文档或批量迁移，HTML 中间方法或 REST API 自动化提供了更多控制。无论哪种方式，在转换之前正确使用 Word 的标题样式都可以确保页面层次结构完整无缺。