MarkdownCo

Markdown to Confluence 转换器

粘贴或上传 Markdown,即可获得可直接用于 Data Center、Server 或 Jira 的 Confluence Wiki Markup。标题、表格、代码块和链接都会转换为对应的 Wiki Markup 写法,LaTeX 公式原样保留,不做任何改动。

输出 Wiki Markup带语言标签的代码宏保留 LaTeX 公式
document.md
confluence.txt

Confluence Wiki Markup

输出内容随输入实时更新。点击「转换并下载」即可保存为文件。

如何将 Markdown 转换为 Confluence

只需三步,即可从 .md 文件得到可直接用于 Confluence 的 Wiki Markup。

1

添加 Markdown 内容

将 Markdown 粘贴到编辑器中,或拖入一个 .md 文件。

2

检查 Wiki Markup

右侧面板会随输入实时显示 Confluence Wiki Markup。导出前请检查代码宏和表格是否正确。

3

转换并下载

点击「转换并下载」可将 Wiki Markup 保存为 .txt 文件,并保留在转换历史中。

Confluence Wiki Markup 的适用场景

Confluence Wiki Markup 是 Confluence Data Center、Server 和 Jira 原生解析的文本格式。用 Markdown 编写、导出时再转换,可以让源文件继续留在 git 中管理,同时团队在 Confluence 里正常阅读。

Confluence Data Center and Server pages
通过 Insert > Markup 粘贴到 Confluence Data Center 和 Server 页面
Jira descriptions and comments
Jira 的描述和评论区,两者使用相同的 Wiki Markup
Bulk migration into Confluence
将 README 和文档仓库批量迁移到 Confluence
Runbooks and technical notes
发布用 Markdown 编写的运维手册和技术笔记

Markdown 如何映射为 Confluence Wiki Markup

每个 Markdown 元素都会转换为对应的 Wiki Markup 写法,且该转换已在包含大量代码和公式的真实技术文档上测试过。

代码块会转换为代码宏

围栏代码块会转换为 {code:language=...} 宏,并保留语言标签,因此 Confluence 中的语法高亮能正常显示。

Code blocks become code macros

表格和链接转换干净整洁

GFM 表格会映射为 ||header|| 表头行和 |cell| 内容行;[text](url) 格式的链接会转换为 [text|url]。嵌套列表会保留原有的层级深度。

Tables and links convert cleanly

LaTeX 公式原样保留,不做任何改动

系统会识别 $$ 代码块和行内 $...$ 公式并原样保留,间距命令、矩阵换行符和转义花括号都不会丢失,因此 Confluence 端的公式宏可以正常渲染。

LaTeX math passes through untouched

标题、引用和分隔线一一对应转换

# 标题会转换为 h1. 到 h6.,引用块会转换为 {quote} 块,分隔线会转换为 ----。文档结构会逐行完整保留。

Headings, quotes, and rules map 1:1

Markdown to Confluence 常见问题

以下解答涵盖 Wiki Markup 输出、代码宏、公式处理以及与 Confluence Cloud 的兼容性。

如何将 Markdown 转换为 Confluence Wiki Markup?

将 Markdown 粘贴到编辑器中,或上传一个 .md 文件。输出面板会随输入实时显示 Wiki Markup 预览。要获取输出内容,请点击「转换并下载」——转换结果会以 .txt 文件保存到转换历史中。此操作需要登录并消耗积分,详情请参见定价页面

这个工具输出的是什么格式?

Confluence Wiki Markup——即 Confluence Data Center、Server 和旧版编辑器所解析的文本语法(h1. 标题、*加粗*、{code} 宏、||table|| 行)。这与 Jira 的描述和评论中使用的是同一套标记体系。

输出结果能在 Confluence Cloud 中使用吗?

部分可以。Confluence Cloud 的新版编辑器已移除 Insert > Markup 选项,因此无法直接粘贴 Wiki Markup。Wiki Markup 可在 Data Center、Server、Cloud 旧版编辑器以及 Jira 中正常使用。如果你使用的是 Cloud 新版编辑器,可以直接粘贴 Markdown 内容——粘贴时大多数语法会自动转换。

代码块是如何转换的?

围栏代码块会转换为 {code:language=...} 宏。起始围栏后的语言标识符(如 ```python、```js)会被带入宏中,因此 Confluence 能应用正确的语法高亮。没有语言标签的代码块会转换为 {code:language=text}。

LaTeX 公式会怎样处理?

公式会逐字节原样保留。转换器会在转换前识别 $$ 代码块和行内 $...$ 公式,并在转换后原样还原,因此像 \, 这样的间距命令和矩阵换行符 \\ 都不会被破坏。Confluence 本身不内置公式渲染功能,需要在你的实例上搭配 LaTeX 公式宏应用来显示输出结果。

支持 Markdown 表格吗?

支持。GitHub 风格的 Markdown 表格会转换为 Confluence 的表格语法:表头行转换为 ||header|| 单元格,内容行转换为 |cell| 行。由于 Wiki Markup 表格不支持列对齐语法,转换时会将其去除。