AI-agentidele pole Markdown-versiooni

Lühike vastus

Kui lehte küsiti päisega Accept: text/markdown, saatis server HTML-i ja leht ei viita ühelegi Markdown-koopiale. AI-agendid loevad siis kogu HTML-i koos menüüde, jaluste ja skriptidega. Markdown-versiooni pakkumine on valikuline: see on noor tava, seega on tase P3.

agent.no_markdown · Prioriteet: P3

Mida see tähendab

Päringule päisega Accept: text/markdown vastas leht HTML-iga ega viita ühelegi Markdown-koopiale (<link rel="alternate" type="text/markdown">). Agendid loevad siis kogu HTML-i koos menüüde ja skriptidega. Valikuline: Markdown agentidele on noor tava, mitte standard.

Miks see AI-otsingu jaoks oluline on

Agendid, kes sirvivad veebi kasutaja eest (ja tööriistad, mis laadivad lehti mudeli konteksti), töötavad tekstiga, mitte paigutusega. Puhas Markdown-versioon on HTML-ist mitu korda väiksem ja säilitab olulised pealkirjad, loendid ja lingid. Mõni CDN ja raamistik vastab päisele Accept: text/markdown juba sellise versiooniga ning llmstxt.org soovitab iga lehe kõrvale .md koopiat.

Ilma selleta ei lähe midagi katki: robotid loevad ikka HTML-i. See on odav parandus pärast seda, kui ligipääsu, robots.txt ja sisu leiud on korras.

Kuidas seda parandada

  1. Vali üks viis Markdowni pakkumiseks: vasta päisele Accept: text/markdown lehe enda URL-il või avalda koopia, näiteks /guide/index.md.
  2. CDN-is lülita sisse selle Markdown-teisendus agentidele, kui see olemas on. Raamistikus lisa vahevara, mis tagastab Markdown-versiooni, kui päis Accept küsib text/markdown.
  3. Saada Content-Type: text/markdown; charset=utf-8 ja, kui URL on sama mis HTML-lehel, ka Vary: Accept.
  4. Viita koopiale HTML-i päises elemendiga <link rel="alternate" type="text/markdown">, et ka agendid, kes sisu üle ei läbirääki, selle leiaksid.
  5. Käivita lehe raportis „Kontrolli uuesti“, et tulemust kinnitada.

Näide

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

Kuidas parandust kinnitada

Pärast muudatust vajuta raportis „Kontrolli uuesti“: see näitab, mis parandati ja kuidas skoor muutus.

Kontrolli minu lehte →

Seotud juhendid

Kõik leiud ja kuidas skoor arvutatakse