AI agentləri üçün Markdown versiyası yoxdur
Səhifə Accept: text/markdown ilə istənəndə server HTML göndərdi və səhifə heç bir Markdown nüsxəsinə keçid vermir. Bu halda AI agentləri bütün HTML-i, menyular, futerlər və skriptlər daxil olmaqla oxuyur. Markdown versiyası vermək istəyə bağlıdır: bu, yeni praktikadır, ona görə də P3-dür.
Nə deməkdir
Accept: text/markdown ilə sorğu göndəriləndə səhifə HTML ilə cavab verdi və heç bir Markdown nüsxəsinə keçid vermir (<link rel="alternate" type="text/markdown">). Bu halda agentlər bütün HTML-i, menyular və skriptlər daxil olmaqla oxuyur. İstəyə bağlıdır: agentlər üçün Markdown standart deyil, yeni yaranan bir praktikadır.
AI axtarışı üçün niyə vacibdir
İstifadəçi üçün veb-də gəzən agentlər (və səhifələri modelin kontekstinə yükləyən alətlər) dizaynla deyil, mətnlə işləyir. Səhifənin təmiz Markdown versiyası HTML-dən bir neçə dəfə kiçikdir və vacib başlıqları, siyahıları və keçidləri saxlayır. Bəzi CDN-lər və freymvorklar Accept: text/markdown sorğusuna artıq belə versiya ilə cavab verir, llmstxt.org isə hər səhifənin yanında .md nüsxəsi saxlamağı təklif edir.
Onsuz heç nə pozulmur: botlar yenə də HTML-i oxuyur. Giriş, robots.txt və məzmun tapıntıları düzəldildikdən sonra bu, ucuz təkmilləşdirmədir.
Necə düzəltmək olar
- Markdown verməyin bir yolunu seçin: səhifənin öz URL-ində
Accept: text/markdownsorğusuna cavab verin və ya/guide/index.mdkimi nüsxə dərc edin. - CDN-də, əgər varsa, onun agentlər üçün Markdown çevirməsini aktiv edin. Freymvorkda
Acceptbaşlığıtext/markdownistədikdə Markdown versiyasını qaytaran middleware əlavə edin. Content-Type: text/markdown; charset=utf-8göndərin, URL HTML səhifə ilə eyni olduqda isəVary: Acceptdə göndərin.- Nüsxəyə HTML-in head hissəsindən
<link rel="alternate" type="text/markdown">ilə keçid verin ki, formatı razılaşdırmayan agentlər də onu tapa bilsin. - Nəticəni təsdiqləmək üçün səhifə hesabatında "Yenidən yoxla" düyməsini basın.
Nümunə
<!-- 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 Düzəlişi necə təsdiqləmək olar
Dəyişiklikdən sonra hesabatda “Yenidən yoxla” düyməsini basın: o, nəyin düzəldildiyini və balın necə dəyişdiyini göstərir.