Confluence 是企业知识的归宿——但要把内容取出来几乎是不可能的。Atlassian 的专有存储格式、笨拙的导出和所见即所得编辑器让提取干净内容变得十分痛苦。以下是如何将 Confluence 页面保存为 Markdown 的方法。

为什么要将 Confluence 保存为 Markdown？

从 Confluence 获取内容出了名地困难：

专有格式 — Confluence 将内容存储为自己的基于 XML 的格式
HTML 导出臃肿 — 充满 Atlassian 宏、样式和标记
没有原生 Markdown 导出 — 导出菜单中没有这个选项
批量导出混乱 — 空间导出会产生带有断开链接的嵌套 HTML
供应商锁定 — 从 Confluence 迁移本身就是一个大工程

Save 从 Confluence 捕获的内容

页面内容

带有标题层级的完整页面文本
表格（正确格式化为 Markdown 表格）
带有语言标签的代码块
信息面板和注释（转换为块引用）
展开/折叠部分（展开的内容）
有序和无序列表
内部和外部链接

示例输出

# 部署运行手册 — 生产 API

**空间：** 工程
**最后更新：** 2026 年 3 月 12 日

---

## 部署前检查清单

- [ ] main 分支上所有 CI 检查通过
- [ ] 数据库迁移已审查并获批
- [ ] 功能标志已配置用于渐进式发布
- [ ] 已确定并准备好值班工程师
- [ ] 已记录回滚计划

## 部署步骤

### 1. 创建发布分支

\`\`\`bash
git checkout main && git pull
git checkout -b release/v2.4.1
git push -u origin release/v2.4.1
\`\`\`

### 2. 运行数据库迁移

| 环境 | 命令 | 超时 |
|------|------|------|
| 预发布 | `npm run migrate:staging` | 5 分钟 |
| 生产 | `npm run migrate:prod` | 15 分钟 |

> **警告：** 始终先在预发布环境运行迁移。
> 生产迁移需要 @devops 批准。

使用场景

从 Confluence 迁移

逐页保存为干净的 Markdown
逐步构建新的知识库
迁移到 Obsidian、Notion、GitBook 或文档即代码系统
无需昂贵的迁移工具

个人知识提取

保存与你工作最相关的页面
构建便携式参考库
离开公司后仍可访问文档
创建关键运行手册的离线副本

文档清理

保存现有页面，在 Markdown 中整理，然后重新导入
作为文档重写的起点
在对比工具中比较新旧版本
审查整个空间的文档质量

AI 驱动搜索

将 Confluence 页面保存为 Markdown 供 AI 处理
将内部文档提供给 AI 工具以获得更好的搜索
为 RAG（检索增强生成）构建 Markdown 语料库
从公司知识库获得 AI 驱动的答案

最佳实践技巧

从页面视图保存 — 不要从编辑器或空间概览保存
展开所有部分 — 保存前点击展开任何折叠/展开宏
附件 — Save 捕获文本内容；如需附件请单独下载
宏 — Confluence 宏（Jira 链接、图表）转换为纯文本或链接
权限 — Save 只能捕获你有权限查看的页面

开始使用

从 Chrome 网上应用店安装 Save — 解放你的 Confluence 内容。

有问题？请联系 [email protected]