วิธีส่งออกหน้า Confluence เป็น Markdown (คู่มือปี 2026)

Confluence ไม่อยากให้คุณออกไป Atlassian เก็บเนื้อหาของคุณในรูปแบบ XML ที่เป็นกรรมสิทธิ์ ไม่มีการส่งออก Markdown และทำให้การดึงข้อมูลจำนวนมากเจ็บปวด ถ้าคุณเคยพยายามดึงข้อความที่สะอาดออกจาก Confluence คุณรู้ความหงุดหงิดนั้น

คู่มือนี้ครอบคลุมทุกวิธีในการส่งออกหน้า Confluence เป็น Markdown --- ตั้งแต่หน้าเดียวไปจนถึงทั้ง space

ทำไมต้องส่งออก Confluence เป็น Markdown?

ทีมออกจาก Confluence ด้วยเหตุผลหลายประการ:

• ย้ายไปยังเครื่องมือใหม่ --- ย้ายไป Notion, GitBook, Docusaurus หรือ static site generator ที่ต้องการ Markdown
• เก็บถาวร knowledge base --- รักษาเอกสารของทีมก่อนที่ใบอนุญาต Atlassian จะหมดอายุ
• สร้าง AI knowledge base --- ป้อนเอกสารที่สะอาดให้ Claude, ChatGPT หรือ LLM ภายใน
• สำรองเอกสารสำคัญ --- มีสำเนาพกพาที่ไม่ขึ้นอยู่กับเซิร์ฟเวอร์ของ Atlassian
• หลีกหนี vendor lock-in --- เป็นเจ้าของเนื้อหาของคุณในรูปแบบสากล

วิธีที่ 1: Save (เร็วที่สุดสำหรับหน้าเดียว)

Save คือส่วนขยาย Chrome ที่แปลงหน้า Confluence ใดก็ได้เป็น Markdown ที่สะอาดด้วยคลิกเดียว

วิธีการทำงาน:

1. เปิดหน้า Confluence ใดก็ได้ใน Chrome
2. คลิกไอคอนส่วนขยาย Save
3. ไฟล์ .md ดาวน์โหลดทันที

สิ่งที่คุณได้รับ:

• ข้อความหน้าเต็มพร้อมลำดับชั้นหัวข้อ
• ตารางจัดรูปแบบเป็นตาราง Markdown
• บล็อคโค้ดพร้อมแท็กภาษา
• แผงข้อมูลแปลงเป็น block quote
• ส่วนที่ขยาย/ยุบ (ขยายเต็มที่)
• metadata ที่สะอาด: ชื่อหน้า ชื่อ space วันที่อัปเดตล่าสุด
• ลิงก์ภายในและภายนอกที่รักษาไว้

สิ่งที่ถูกลบ:

• Atlassian macros และการจัดรูปแบบที่เป็นกรรมสิทธิ์
• navigation chrome, sidebar และเมนู
• อาร์ติแฟกต์จาก WYSIWYG editor
• Inline styles และ CSS

เหมาะที่สุดสำหรับ: บันทึกหน้าเดียวหรือกลุ่มเล็กๆ ถ้าคุณต้องการ 5-50 หน้า นี่คือวิธีที่เร็วที่สุด

ตัวอย่าง Output

จาก Confluence runbook ทั่วไป:

# Deployment Runbook --- Production API

**Space:** Engineering
**Last updated:** March 12, 2026

---

## Pre-Deployment Checklist

- [ ] All CI checks passing on `main`
- [ ] Database migrations reviewed and approved
- [ ] Feature flags configured for gradual rollout
- [ ] Rollback plan documented

## Deployment Steps

### 1. Create Release Branch

\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`

### 2. Run Database Migrations

\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`

วิธีที่ 2: การส่งออกในตัวของ Confluence (HTML แล้วแปลง)

Confluence สามารถส่งออกหน้าเป็น HTML จากนั้นคุณแปลง HTML เป็น Markdown โดยใช้เครื่องมืออย่าง Pandoc

ขั้นตอน:

1. ไปที่หน้า → เมนู … → Export to PDF/Word/HTML
2. เลือก HTML export
3. แปลงด้วย Pandoc: pandoc input.html -o output.md

ปัญหาของวิธีนี้:

• HTML export รวม CSS ของ Atlassian, macros และ inline styles
• ตารางมักพังระหว่างการแปลง
• บล็อคโค้ดสูญเสียแท็กภาษา
• รูปภาพอ้างอิง URL ของ Confluence ที่อาจพังในภายหลัง
• หน้าที่ซ้อนกันต้องส่งออกทั้ง space

วิธีนี้ทำงานได้แต่ให้ output ที่รกซึ่งต้องทำความสะอาดด้วยตนเอง

วิธีที่ 3: Space Export + การแปลงจำนวนมาก

สำหรับส่งออก Confluence space ทั้งหมด:

1. ไปที่ Space Settings → Content Tools → Export
2. เลือกรูปแบบ HTML
3. ดาวน์โหลด ZIP archive
4. ใช้ script เพื่อแปลงไฟล์ HTML เป็น Markdown เป็น batch

ปัญหา: Confluence space exports ให้ HTML ที่ซ้อนลึกพร้อมลิงก์ relative ที่พัง, navigation elements ซ้ำ และ markup เฉพาะของ Atlassian การทำความสะอาดโดยทางโปรแกรมเป็นโปรเจกต์สุดสัปดาห์

วิธีที่ 4: Confluence REST API

สำหรับการเข้าถึงแบบโปรแกรม:

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

นี่ให้รูปแบบ raw storage (คล้าย XHTML) คุณต้องการ:

1. แยกวิเคราะห์รูปแบบ storage ของ Atlassian
2. จัดการ macros, embeds และ elements พิเศษ
3. แปลงเป็น Markdown
4. ทำซ้ำสำหรับทุกหน้า

เหมาะที่สุดสำหรับ: ทีม engineering ที่สร้าง migration pipeline เกินความจำเป็นสำหรับกรณีใช้งานส่วนใหญ่

ควรใช้วิธีใด?

สถานการณ์	วิธีที่ดีที่สุด
บันทึก 1-50 หน้าอย่างรวดเร็ว	Save extension --- คลิกเดียวต่อหน้า
เก็บถาวร space ทั้งหมด	Space export + Pandoc --- จำนวนมากแต่รก
สร้าง migration pipeline	REST API --- โดยโปรแกรมแต่ซับซ้อน
สำรองเอกสารสำคัญอย่างรวดเร็ว	Save extension --- output สะอาดที่สุด
ป้อนเอกสารให้ LLM	Save extension --- Markdown เป็น native ของ LLM

สำหรับคนส่วนใหญ่ Save คือคำตอบ มันให้ Markdown ที่สะอาดที่สุดโดยไม่ต้องตั้งค่า และจัดการการจัดรูปแบบที่เป็นกรรมสิทธิ์ของ Confluence โดยอัตโนมัติ

ทำให้เนื้อหา Confluence ของคุณมีประโยชน์

เมื่อคุณส่งออกหน้าเป็น Markdown แล้ว คุณสามารถ:

• ค้นหาทุกอย่าง ด้วย grep, VS Code หรือ Obsidian
• ป้อนให้ Claude หรือ ChatGPT เพื่อตอบคำถามเกี่ยวกับเอกสารของคุณทันที
• Version control ใน Git --- ติดตามการเปลี่ยนแปลงในเอกสารของคุณเหมือนโค้ด
• นำเข้าสู่เครื่องมือใดก็ได้ --- Notion, Obsidian, GitBook, Docusaurus หรือ static site generator
• เก็บไว้ตลอดไป --- ไฟล์ Markdown คือข้อความธรรมดา ยังอ่านได้อีก 50 ปี

เริ่มต้น

ติดตั้ง Save และลองใช้กับหน้า Confluence ตอนนี้เลย ฟรีในการเริ่มต้น และคุณจะเห็น Markdown ที่สะอาดภายในไม่กี่วินาที

---

การหลีกหนีจาก Confluence ไม่จำเป็นต้องเจ็บปวด Save แปลงทุกหน้าเป็น Markdown ที่สะอาดด้วยคลิกเดียว