Tidak ada versi Markdown untuk agen AI
Saat halaman diminta dengan Accept: text/markdown, server mengirim HTML, dan halaman tidak menautkan salinan Markdown. Agen AI lalu membaca seluruh HTML, termasuk menu, footer, dan skrip. Menyajikan versi Markdown bersifat opsional: ini konvensi yang masih baru, jadi prioritasnya P3.
Artinya
Saat diminta dengan Accept: text/markdown, halaman menjawab dengan HTML dan tidak menautkan salinan Markdown (<link rel="alternate" type="text/markdown">). Agen lalu membaca seluruh HTML, termasuk menu dan skrip. Opsional: Markdown untuk agen adalah konvensi yang masih baru, bukan standar.
Mengapa penting untuk pencarian AI
Agen yang menjelajah untuk pengguna (dan alat yang memuat halaman ke dalam konteks model) bekerja dengan teks, bukan tata letak. Versi Markdown yang bersih dari sebuah halaman beberapa kali lebih kecil daripada HTML-nya dan tetap mempertahankan judul, daftar, dan tautan yang penting. Beberapa CDN dan framework sudah menjawab Accept: text/markdown dengan versi seperti itu, dan llmstxt.org menyarankan salinan .md di samping setiap halaman.
Tidak ada yang rusak tanpanya: crawler tetap membaca HTML. Ini peningkatan yang murah setelah temuan akses, robots.txt, dan konten diperbaiki.
Cara memperbaikinya
- Pilih satu cara menyajikan Markdown: jawab
Accept: text/markdowndi URL halaman itu sendiri, atau terbitkan salinan seperti/guide/index.md. - Di CDN, aktifkan konversi Markdown untuk agen jika tersedia. Di framework, tambahkan middleware yang mengembalikan versi Markdown saat header
Acceptmemintatext/markdown. - Kirim
Content-Type: text/markdown; charset=utf-8dan, jika URL-nya sama dengan halaman HTML,Vary: Accept. - Tautkan salinan itu dari head HTML dengan
<link rel="alternate" type="text/markdown">, agar agen yang tidak bernegosiasi konten juga dapat menemukannya. - Jalankan "Periksa lagi" pada laporan halaman untuk memastikan hasilnya.
Contoh
<!-- 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 Cara memastikan perbaikannya
Setelah perubahan, tekan "Periksa lagi" pada laporan: laporan mencantumkan apa yang diperbaiki dan bagaimana skor berubah.