📚 CMS สำหรับคู่มือ: Docusaurus vs Astro

เครื่องมือแปลงไฟล์ Markdown → เว็บไซต์เอกสารสวย ๆ

CMS / Static Site Generator = เขียนเนื้อหาเป็นไฟล์ Markdown แล้วมันสร้างเป็นเว็บไซต์ให้อัตโนมัติ (มี sidebar, search, ธีม) — เราแค่โฟกัสที่ เนื้อหา

📝 แล้ว Markdown คืออะไร

วิธีเขียนข้อความให้ จัดรูปแบบเองอัตโนมัติ ด้วยสัญลักษณ์ง่าย ๆ — พิมพ์เป็น text ธรรมดา ไม่ต้องกดปุ่มจัดหน้าเหมือน Word เซฟเป็นไฟล์ .md แล้วเว็บก็แปลงเป็นหน้าสวย ๆ ให้

เขียนแบบนี้
# หัวข้อใหญ่
## หัวข้อรอง

**ตัวหนา** และ *ตัวเอียง*

- รายการข้อ 1
- รายการข้อ 2

[ลิงก์](https://...)
`โค้ดสั้น ๆ`
ได้ออกมาแบบนี้
หัวข้อใหญ่
หัวข้อรอง

ตัวหนา และ ตัวเอียง

  • รายการข้อ 1
  • รายการข้อ 2

ลิงก์ โค้ดสั้น ๆ

💡 MDX = Markdown + แทรก component/HTML ได้ (เช่นการ์ด, กล่องเตือน) — Docusaurus/Astro ใช้ตัวนี้

🔄 มันทำงานยังไง

เขียน Markdown/MDX
→
build
→
ได้เว็บ static
→
deploy

เขียนครั้งเดียว build ทีเดียว ได้ไฟล์ HTML/CSS/JS พร้อมอัปขึ้น host ได้เลย

⚖️ เทียบ Docusaurus vs Astro

Docusaurus

เทคโนโลยี: React (MDX)

  • เหมาะกับคู่มือ/เอกสารเน้น ๆ, ต้องการ versioning
  • จุดเด่นระบบ docs ครบ — sidebar, search, i18n, versioning มาให้เลย
  • เริ่มเร็วถ้าทำ "เอกสารล้วน"

Astro / Starlight

เทคโนโลยี: ใช้ได้หลาย framework

  • เหมาะกับเว็บทั่วไป + เอกสารผสมกัน, เน้นเร็ว
  • จุดเด่นโหลดเร็วมาก, ยืดหยุ่น, ส่ง JS น้อย
  • เริ่มเร็วถ้าอยากได้ทั้งเว็บและ docs

🧭 เลือกอันไหนดี

อยากได้ระบบเอกสารครบ ๆ มี versioning → Docusaurus
อยากได้เว็บเร็ว ยืดหยุ่น เอกสารเป็นส่วนหนึ่ง → Astro (Starlight)
ทั้งคู่รับ Markdown/MDX เหมือนกัน → ย้ายเนื้อหากันได้

📄 หน้าตาไฟล์เอกสาร (frontmatter)

---
title: เริ่มต้นใช้งาน
sidebar_position: 1
---

# เริ่มต้นใช้งาน

เนื้อหาเขียนเป็น Markdown ปกติ...

💡 เนื้อหา (Markdown) ย้ายข้ามได้ทั้งคู่ — เลือกจาก "ระบบรอบ ๆ" ที่ต้องการ ไม่ใช่ที่ตัวเนื้อหา