ไม่มีเวอร์ชัน Markdown สำหรับเอเจนต์ AI

คำตอบสั้น

เมื่อขอหน้าด้วย Accept: text/markdown เซิร์ฟเวอร์ส่ง HTML กลับมา และหน้าไม่ได้ลิงก์ไปยังสำเนา Markdown เอเจนต์ AI จึงต้องอ่าน HTML ทั้งหมด รวมถึงเมนู ส่วนท้าย และสคริปต์ การให้บริการเวอร์ชัน Markdown เป็นทางเลือก เพราะยังเป็นแนวปฏิบัติใหม่ ข้อนี้จึงเป็น P3

agent.no_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 และเนื้อหาเสร็จแล้ว

วิธีแก้ไข

  1. เลือกวิธีให้บริการ Markdown หนึ่งวิธี: ตอบ Accept: text/markdown ที่ URL ของหน้าเอง หรือเผยแพร่สำเนา เช่น /guide/index.md
  2. หากใช้ CDN ที่มีฟีเจอร์แปลงเป็น Markdown สำหรับเอเจนต์ ให้เปิดใช้ ในเฟรมเวิร์ก ให้เพิ่ม middleware ที่ส่งเวอร์ชัน Markdown กลับเมื่อเฮดเดอร์ Accept ขอ text/markdown
  3. ส่ง Content-Type: text/markdown; charset=utf-8 และเมื่อ URL เป็นอันเดียวกับหน้า HTML ให้ส่ง Vary: Accept ด้วย
  4. ลิงก์สำเนาจาก head ของ HTML ด้วย <link rel="alternate" type="text/markdown"> เพื่อให้เอเจนต์ที่ไม่ได้เจรจาเนื้อหาหาเจอเช่นกัน
  5. กด "ตรวจสอบอีกครั้ง" ในรายงานของหน้าเพื่อยืนยันผล

ตัวอย่าง

<!-- 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

วิธียืนยันว่าแก้ได้ผล

หลังจากแก้ไขแล้ว กด "ตรวจสอบอีกครั้ง" ในรายงาน รายงานจะแสดงสิ่งที่แก้แล้วและคะแนนที่เปลี่ยนไป

ตรวจสอบหน้าของฉัน →

คู่มือที่เกี่ยวข้อง

ข้อค้นพบทั้งหมดและวิธีคิดคะแนน