ไม่มีเวอร์ชัน Markdown สำหรับเอเจนต์ AI
เมื่อขอหน้าด้วย Accept: text/markdown เซิร์ฟเวอร์ส่ง HTML กลับมา และหน้าไม่ได้ลิงก์ไปยังสำเนา Markdown เอเจนต์ AI จึงต้องอ่าน HTML ทั้งหมด รวมถึงเมนู ส่วนท้าย และสคริปต์ การให้บริการเวอร์ชัน Markdown เป็นทางเลือก เพราะยังเป็นแนวปฏิบัติใหม่ ข้อนี้จึงเป็น P3
หมายความว่าอย่างไร
เมื่อขอด้วย Accept: text/markdown หน้าเว็บตอบกลับเป็น HTML และไม่ได้ลิงก์ไปยังสำเนา Markdown (<link rel="alternate" type="text/markdown">) เอเจนต์จึงต้องอ่าน HTML ทั้งหมด รวมถึงเมนูและสคริปต์ เป็นทางเลือก: Markdown สำหรับเอเจนต์ยังเป็นแนวปฏิบัติใหม่ ไม่ใช่มาตรฐาน
ทำไมจึงสำคัญต่อการค้นหาด้วย AI
เอเจนต์ที่ท่องเว็บแทนผู้ใช้ (และเครื่องมือที่โหลดหน้าเว็บเข้าบริบทของโมเดล) ทำงานกับข้อความ ไม่ใช่เลย์เอาต์ เวอร์ชัน Markdown ที่สะอาดของหน้าเล็กกว่า HTML หลายเท่า และยังเก็บหัวข้อ รายการ และลิงก์ที่สำคัญไว้ครบ CDN และเฟรมเวิร์กบางตัวตอบ Accept: text/markdown ด้วยเวอร์ชันแบบนี้อยู่แล้ว และ llmstxt.org แนะนำให้มีสำเนา .md วางคู่กับแต่ละหน้า
ถ้าไม่มีก็ไม่มีอะไรเสีย crawler ยังอ่าน HTML ได้ตามปกติ นี่เป็นการปรับปรุงที่ทำได้ง่ายเมื่อแก้ข้อค้นพบด้านการเข้าถึง robots.txt และเนื้อหาเสร็จแล้ว
วิธีแก้ไข
- เลือกวิธีให้บริการ Markdown หนึ่งวิธี: ตอบ
Accept: text/markdownที่ URL ของหน้าเอง หรือเผยแพร่สำเนา เช่น/guide/index.md - หากใช้ CDN ที่มีฟีเจอร์แปลงเป็น Markdown สำหรับเอเจนต์ ให้เปิดใช้ ในเฟรมเวิร์ก ให้เพิ่ม middleware ที่ส่งเวอร์ชัน Markdown กลับเมื่อเฮดเดอร์
Acceptขอtext/markdown - ส่ง
Content-Type: text/markdown; charset=utf-8และเมื่อ URL เป็นอันเดียวกับหน้า HTML ให้ส่งVary: Acceptด้วย - ลิงก์สำเนาจาก head ของ HTML ด้วย
<link rel="alternate" type="text/markdown">เพื่อให้เอเจนต์ที่ไม่ได้เจรจาเนื้อหาหาเจอเช่นกัน - กด "ตรวจสอบอีกครั้ง" ในรายงานของหน้าเพื่อยืนยันผล
ตัวอย่าง
<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">
# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept วิธียืนยันว่าแก้ได้ผล
หลังจากแก้ไขแล้ว กด "ตรวจสอบอีกครั้ง" ในรายงาน รายงานจะแสดงสิ่งที่แก้แล้วและคะแนนที่เปลี่ยนไป