AI agentləri üçün Markdown versiyası yoxdur

Qısa cavab

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.

agent.no_markdown · Prioritet: P3

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

  1. Markdown verməyin bir yolunu seçin: səhifənin öz URL-ində Accept: text/markdown sorğusuna cavab verin və ya /guide/index.md kimi nüsxə dərc edin.
  2. CDN-də, əgər varsa, onun agentlər üçün Markdown çevirməsini aktiv edin. Freymvorkda Accept başlığı text/markdown istədikdə Markdown versiyasını qaytaran middleware əlavə edin.
  3. Content-Type: text/markdown; charset=utf-8 göndərin, URL HTML səhifə ilə eyni olduqda isə Vary: Accept də göndərin.
  4. 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.
  5. 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.

Səhifəmi yoxla →

Əlaqəli bələdçilər

Bütün tapıntılar və balın necə hesablandığı