Nu există o versiune Markdown pentru agenții AI

Răspuns scurt

La o cerere a paginii cu Accept: text/markdown, serverul a trimis HTML, iar pagina nu trimite la nicio copie Markdown. Agenții AI citesc atunci tot HTML-ul, inclusiv meniurile, subsolurile și scripturile. O versiune Markdown este opțională: e o convenție tânără, de aceea are P3.

agent.no_markdown · Prioritate: P3

Ce înseamnă

La o cerere cu Accept: text/markdown, pagina a răspuns cu HTML și nu trimite la nicio copie Markdown (<link rel="alternate" type="text/markdown">). Agenții citesc atunci tot HTML-ul, inclusiv meniurile și scripturile. Opțional: Markdown pentru agenți este o convenție tânără, nu un standard.

De ce contează pentru căutarea AI

Agenții care navighează pentru un utilizator (și uneltele care încarcă pagini în contextul unui model) lucrează cu text, nu cu aspect grafic. O versiune Markdown curată a unei pagini este de câteva ori mai mică decât HTML-ul ei și păstrează titlurile, listele și linkurile care contează. Unele CDN-uri și framework-uri răspund deja la Accept: text/markdown cu o astfel de versiune, iar llmstxt.org sugerează o copie .md lângă fiecare pagină.

Fără ea nu se strică nimic: crawlerele citesc în continuare HTML-ul. Este o îmbunătățire ieftină după ce ai rezolvat constatările de acces, robots.txt și conținut.

Cum se remediază

  1. Alege un singur mod de a servi Markdown: răspunde la Accept: text/markdown la URL-ul paginii sau publică o copie precum /guide/index.md.
  2. Pe un CDN, activează conversia în Markdown pentru agenți, dacă există. Într-un framework, adaugă un middleware care returnează versiunea Markdown când antetul Accept cere text/markdown.
  3. Trimite Content-Type: text/markdown; charset=utf-8 și, când URL-ul este același cu al paginii HTML, Vary: Accept.
  4. Leagă copia din head-ul HTML cu <link rel="alternate" type="text/markdown">, ca s-o găsească și agenții care nu negociază conținutul.
  5. Rulează „Verifică din nou” în raportul paginii ca să confirmi rezultatul.

Exemplu

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

Cum confirmi remediul

După modificare, apasă „Verifică din nou” în raport: vezi ce s-a remediat și cum s-a schimbat scorul.

Verifică pagina mea →

Ghiduri conexe

Toate constatările și cum funcționează scorul