Confluence là nơi kiến thức doanh nghiệp tập trung — và cũng là nơi gần như không thể lấy nội dung ra ngoài. Định dạng lưu trữ độc quyền của Atlassian, công cụ xuất cồng kềnh, và trình soạn thảo WYSIWYG khiến việc trích xuất nội dung sạch trở nên đau đầu. Đây là cách lưu trang Confluence dưới dạng Markdown.

Tại Sao Lưu Confluence Dưới Dạng Markdown?

Việc lấy nội dung ra khỏi Confluence vốn nổi tiếng khó khăn:

Định dạng độc quyền — Confluence lưu nội dung dưới dạng XML riêng
Xuất HTML cồng kềnh — đầy Atlassian macros, styles, và markup
Không có xuất Markdown gốc — không có trong menu xuất
Xuất hàng loạt lộn xộn — xuất space tạo ra HTML lồng nhau với liên kết hỏng
Phụ thuộc nhà cung cấp — di chuyển khỏi Confluence là cả một dự án

Save Nắm Bắt Gì Từ Confluence

Nội Dung Trang

Toàn bộ văn bản trang với cấu trúc heading
Bảng (được định dạng đúng thành Markdown tables)
Code blocks với language tags
Info panels và notes (chuyển đổi thành block quotes)
Mục mở rộng/thu gọn (nội dung được mở rộng)
Danh sách có dấu chấm và đánh số
Liên kết nội bộ và bên ngoài

Ví Dụ Output

# Runbook Triển Khai — Production API

**Space:** Engineering
**Cập nhật lần cuối:** 12 tháng 3, 2026

---

## Danh Sách Kiểm Tra Trước Triển Khai

- [ ] Tất cả kiểm tra CI đã pass trên main
- [ ] Database migrations đã được xem xét và phê duyệt
- [ ] Feature flags đã được cấu hình cho rollout dần dần
- [ ] Kỹ sư trực đã được xác định và sẵn sàng
- [ ] Kế hoạch rollback đã được tài liệu hóa

## Các Bước Triển Khai

### 1. Tạo Release Branch

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

### 2. Chạy Database Migrations

| Môi trường | Lệnh | Timeout |
|-------------|---------|---------|
| Staging | `npm run migrate:staging` | 5 phút |
| Production | `npm run migrate:prod` | 15 phút |

> **Cảnh báo:** Luôn chạy migrations trên staging trước.
> Migrations production yêu cầu phê duyệt từ @devops.

### 3. Triển Khai lên Production

Triển khai qua pipeline CI/CD. Theo dõi các chỉ số sau:
- Tỷ lệ lỗi (nên duy trì dưới 0.1%)
- P99 latency (nên duy trì dưới 200ms)
- Mức sử dụng connection pool của database

Các Trường Hợp Sử Dụng

Di Chuyển Khỏi Confluence

Lưu từng trang một thành Markdown sạch
Xây dựng knowledge base mới dần dần
Di chuyển sang Obsidian, Notion, GitBook, hoặc hệ thống docs-as-code
Không cần công cụ migration đắt tiền

Trích Xuất Kiến Thức Cá Nhân

Lưu các trang quan trọng nhất với công việc của bạn
Xây dựng thư viện tham khảo di động
Giữ quyền truy cập tài liệu sau khi rời công ty
Tạo bản sao offline của các runbook quan trọng

Dọn Dẹp Tài Liệu

Lưu trang hiện có, chỉnh sửa trong Markdown, và nhập lại
Dùng làm điểm khởi đầu để viết lại tài liệu
So sánh phiên bản cũ và mới bằng công cụ diff
Kiểm tra chất lượng tài liệu trên toàn space

Tìm Kiếm Hỗ Trợ Bởi AI

Lưu trang Confluence dưới dạng Markdown để xử lý AI
Đưa tài liệu nội bộ vào công cụ AI để tìm kiếm tốt hơn
Xây dựng kho Markdown cho RAG (Retrieval-Augmented Generation)
Nhận câu trả lời từ AI dựa trên knowledge base của công ty

Mẹo Để Có Kết Quả Tốt Nhất

Lưu từ chế độ xem trang — không phải trình soạn thảo, không phải tổng quan space
Mở rộng tất cả mục — nhấp để mở rộng bất kỳ macro thu gọn/mở rộng nào trước khi lưu
Tệp đính kèm — Save nắm bắt nội dung văn bản; tải xuống tệp đính kèm riêng nếu cần
Macros — Confluence macros (Jira links, biểu đồ) chuyển đổi thành văn bản thuần hoặc links
Quyền — Save chỉ có thể nắm bắt các trang bạn có quyền xem

Bắt Đầu

Cài Save từ Chrome Web Store — giải phóng nội dung Confluence của bạn.

Có câu hỏi? Liên hệ tại [email protected]