← Quay lại blog

Cách Xuất Trang Confluence Sang Markdown (Hướng Dẫn 2026)

· Save Team
confluencemarkdowndocumentationenterprisemigration

Confluence không muốn bạn rời đi. Atlassian lưu trữ nội dung của bạn ở định dạng XML độc quyền, không cung cấp xuất Markdown, và làm cho việc trích xuất hàng loạt trở nên khó khăn. Nếu bạn đã từng cố gắng lấy văn bản sạch ra khỏi Confluence, bạn biết sự bực bội.

Tại Sao Xuất Confluence Sang Markdown?

  • Di chuyển sang công cụ mới — chuyển sang Notion, GitBook, Docusaurus
  • Lưu trữ cơ sở kiến thức — bảo tồn tài liệu trước khi giấy phép Atlassian hết hạn
  • Xây dựng cơ sở kiến thức AI — đưa tài liệu sạch vào Claude, ChatGPT, hoặc LLM nội bộ
  • Thoát khỏi vendor lock-in — sở hữu nội dung ở định dạng phổ quát

Phương Pháp 1: Tiện Ích Mở Rộng Save (Nhanh Nhất Cho Trang Đơn)

Save là tiện ích mở rộng Chrome chuyển đổi bất kỳ trang Confluence nào sang Markdown sạch chỉ với một cú nhấp.

Cách hoạt động:

  1. Mở bất kỳ trang Confluence nào trong Chrome
  2. Nhấp vào biểu tượng tiện ích mở rộng Save
  3. Tệp .md tải xuống ngay lập tức

Kết quả nhận được:

  • Toàn bộ văn bản trang với phân cấp tiêu đề
  • Bảng được định dạng như bảng Markdown
  • Khối code với thẻ ngôn ngữ
  • Bảng thông tin được chuyển đổi thành trích dẫn khối
  • Siêu dữ liệu sạch: tiêu đề trang, tên không gian, ngày cập nhật lần cuối

Tốt nhất cho: Lưu trang đơn lẻ hoặc lô nhỏ.

Phương Pháp 2: Xuất Tích Hợp Của Confluence (HTML, Sau Đó Chuyển Đổi)

Confluence có thể xuất trang dưới dạng HTML. Sau đó bạn có thể chuyển đổi HTML sang Markdown bằng Pandoc: pandoc input.html -o output.md

Vấn đề: HTML xuất bao gồm CSS, macro và kiểu nội tuyến của Atlassian. Bảng thường bị hỏng trong quá trình chuyển đổi.

Phương Pháp 3: API REST Của Confluence

Dành cho truy cập lập trình:

curl -u [email protected]:API_TOKEN \
  "https://your-domain.atlassian.net/wiki/rest/api/content/PAGE_ID?expand=body.storage" \
  | jq -r '.body.storage.value' > page.html

Tốt nhất cho: Nhóm kỹ thuật xây dựng pipeline di chuyển.

Phương Pháp Nào Nên Dùng?

Tình huốngPhương pháp tốt nhất
Lưu 1-50 trang nhanhTiện ích mở rộng Save
Lưu trữ toàn bộ không gianSpace export + Pandoc
Xây dựng pipeline di chuyểnREST API
Đưa tài liệu vào LLMTiện ích mở rộng Save

Thoát khỏi Confluence không cần phải đau đầu. Save chuyển đổi bất kỳ trang nào sang Markdown sạch chỉ với một cú nhấp.