← 返回部落格

如何將 Confluence 頁面儲存為 Markdown

· Save Team
confluencedocumentationwikienterprise

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 驅動的答案

最佳實踐技巧

  1. 從頁面檢視儲存 — 不要從編輯器或空間概覽儲存
  2. 展開所有部分 — 儲存前點擊展開任何折疊/展開宏
  3. 附件 — Save 擷取文字內容;如需附件請單獨下載
  4. — Confluence 宏(Jira 連結、圖表)轉換為純文字或連結
  5. 權限 — Save 只能擷取你有權限查看的頁面

開始使用

從 Chrome 線上應用程式商店安裝 Save — 解放你的 Confluence 內容。


有問題嗎?請聯繫 [email protected]