ทำไมทีม Claude เริ่มใช้ HTML แทน Markdown — เพราะงาน AI ที่คนไม่อ่าน เท่ากับไม่มี Human Gate

ทีมที่ใช้ Claude Code เริ่มพูดถึงการใช้ HTML แทน Markdown สำหรับงานบางประเภท โดยเฉพาะ spec, plan หรือ PR explainer ที่ยาวและซับซ้อน เหตุผลตรงไปตรงมา: Markdown ดีมากสำหรับข้อความและ checklist แต่พอเนื้อหายาวเกินไป มันกลายเป็นกำแพงตัวอักษรที่คนไม่อยากอ่าน

HTML เปิดทางให้ Claude สร้าง output ที่ตรวจง่ายกว่า เช่น diagram ด้วย SVG, table ที่จัดรูปแบบดี, interactive mockup หรือ prototype ที่มี slider และ knob ให้ลองปรับได้ สิ่งนี้ทำให้คนอยู่ใน loop ได้จริงมากขึ้น

ประเด็นสำคัญคือ Human Gate ถ้าเราบอกว่าคนต้องตรวจ แต่ output ที่ส่งให้คนตรวจอ่านยากจนไม่มีใครอ่าน Human Gate นั้นก็เป็นแค่พิธี ไม่ใช่การควบคุมคุณภาพจริง

HTML ไม่ใช่คำตอบสำหรับทุกงาน ข้อเสียชัดเจนคือใช้ token มากขึ้น generate ช้ากว่า และ diff ใน Git มัก noisy จน review แบบบรรทัดต่อบรรทัดยากกว่า Markdown มาก แหล่งข้อมูลพูดถึงว่า HTML อาจใช้เวลาสร้างมากกว่า 2-4 เท่าในบางงาน

ดังนั้นควรใช้ HTML เมื่อ output นั้นคุ้มกับการอ่านของคน เช่น architecture options, product spec, design plan, PR explainer, data-heavy table หรือ decision document ที่ต้องให้หลายคนเข้าใจตรงกัน

ถ้าเป็น note สั้น checklist ง่าย หรือ prompt instruction ที่ AI ต้องอ่าน ไม่จำเป็นต้องใช้ HTML เสมอไป Markdown ยังเร็วกว่า เบากว่า และ diff ง่ายกว่า

ฟันธง: ถ้าใช้ AI ช่วยทำ spec หรือ PR ใหญ่ ๆ ควรลองให้ AI สร้าง HTML explainer ประกอบ ไม่ใช่แทนเอกสารทุกอย่าง แต่เป็นชั้น presentation ที่ช่วยให้คนตรวจเร็วขึ้น

ตัวอย่างที่ใช้ได้จริงคือให้ Claude สร้าง HTML สรุป architecture options 2-3 ทาง พร้อม trade-off, diagram และ table แล้วให้ทีมอ่านก่อนตัดสินใจ หรือให้มันแนบ HTML explainer สำหรับ PR ใหญ่ที่ diff อ่านยาก

หลักคิดคืออย่าให้ AI สร้างงานที่คนไม่ตรวจ เพราะนั่นเท่ากับเราเอา Human Gate ออกโดยไม่รู้ตัว งานที่ใช้ AI ต้องตรวจสอบได้ และบางครั้งการเปลี่ยน format จาก Markdown เป็น HTML ก็คือวิธีทำให้การตรวจนั้นเกิดขึ้นจริง