Docusaurus v3.10 Update

April 8, 2026 · 2 min read

Docusaurus อัปเดตแพทช์ใหม่ในรอบ 5 เดือน ส่วนเราต้องมารื้อทั้งระบบ

เมื่อวานนี้ (7 เมษายน พ.ศ. 2569) ทางผู้พัฒนา Docusaurus ได้อัปเดตเฟรมเวิร์กเป็นเวอร์ชั่น 3.10 ที่ห่างจากการปรับปรุงรอบล่าสุด 5 เดือน (จากเวอร์ชั่น 3.9)

เราเลือกที่จะทำเว็บไซต์ใหม่แทนการมานั่งอัปเกรด ใช้ CLI เพื่อสร้างใหม่ทั้งหมด แล้วค่อยก๊อปปี้ไฟล์มาใส่ในโปรเจคใหม่ เตรียมรันคำสั่ง pnpm run dev ปัญหาก็เกิดขึ้นทันที มีการแจ้งเตือนว่าไฟล์ไม่ถูกต้อง

อัปเดตรุ่นล่าสุดก็คือ ระบบจะให้ทุกคนหันไปใช้ไฟล์แบบ .mdx แทน .md เพราะว่าต้องการให้ไฟล์มันรองรับกับระบบอื่นด้วย (compatibility) ทำให้เราต้องเปลี่ยนพวก  ทั้งหมดเป็นแบบ MDX {/* truncate */}

Strict MDX

This release introduces new MDX options to encourage stricter usage of native MDX syntax, instead of relying on proprietary Docusaurus syntax on top of MDX.

Historically, Docusaurus compiled your files with MDX v1, which was quite forgiving. Since then, the ecosystem has widely moved to MDX v3, which is stricter. Docusaurus v3.0 introduced markdown.mdx1Compat to help you upgrade incrementally. — Sébastien Lorber, Docusaurus maintainer

เท่านั้นยังไม่พอ เนื่องด้วยจากความที่ว่าเราต้องเปลี่ยนเป็นไฟล์ MDX ทั้งหมด ทำให้เราต้องเปลี่ยนโครงสร้างแทบทุกอย่าง ตั้งแต่ย้ายแท็ก <head> หรือ import มาไว้ด้านบนสุด แล้วเรามีบทความประมาณ 20 บทความ แล้วเป็นไฟล์ md ประมาณ 90% เรียกได้ว่าต้องมานั่งแก้ใหม่ทั้งหมด

แต่ก็ดี เพราะว่าเราก็วางแผนที่จะทยอยปรับความกว้างของรูปภาพเป็น 1200 px แทน 990 px ที่ใช้อยู่ปัจจุบัน

รอติดตามกันต่อไป