Chýba verzia v Markdowne pre AI agentov

Krátka odpoveď

Na požiadavku na stránku s Accept: text/markdown server poslal HTML a stránka neodkazuje na žiadnu kópiu v Markdowne. AI agenti potom čítajú celé HTML vrátane menu, pätičiek a skriptov. Verzia v Markdowne je nepovinná: ide o mladú konvenciu, preto je to P3.

agent.no_markdown · Priorita: P3

Čo to znamená

Na požiadavku s Accept: text/markdown stránka odpovedala HTML a neodkazuje na žiadnu kópiu v Markdowne (<link rel="alternate" type="text/markdown">). Agenti potom čítajú celé HTML vrátane menu a skriptov. Nepovinné: Markdown pre agentov je mladá konvencia, nie štandard.

Prečo je to dôležité pre AI vyhľadávanie

Agenti, ktorí prechádzajú web za používateľa (a nástroje, ktoré načítavajú stránky do kontextu modelu), pracujú s textom, nie s rozložením. Čistá verzia stránky v Markdowne je niekoľkokrát menšia ako jej HTML a zachováva nadpisy, zoznamy a odkazy, na ktorých záleží. Niektoré CDN a frameworky už na Accept: text/markdown odpovedajú takouto verziou a llmstxt.org navrhuje kópiu .md vedľa každej stránky.

Bez nej sa nič nepokazí: crawlery ďalej čítajú HTML. Je to lacné vylepšenie, keď sú zistenia k prístupu, robots.txt a obsahu už opravené.

Ako to opraviť

  1. Vyberte jeden spôsob, ako Markdown servírovať: odpovedajte na Accept: text/markdown na vlastnej URL stránky alebo zverejnite kópiu, napríklad /guide/index.md.
  2. Ak vaše CDN vie prevod do Markdownu pre agentov, zapnite ho. Vo frameworku pridajte middleware, ktorý vráti verziu v Markdowne, keď hlavička Accept žiada text/markdown.
  3. Posielajte Content-Type: text/markdown; charset=utf-8 a ak je URL rovnaká ako pri stránke HTML, aj Vary: Accept.
  4. Odkážte na kópiu z hlavičky HTML pomocou <link rel="alternate" type="text/markdown">, aby ju našli aj agenti, ktorí formát nevyjednávajú.
  5. V správe o stránke spustite „Skontrolovať znova“ a overte výsledok.

Príklad

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

Ako overiť opravu

Po zmene stlačte v správe „Skontrolovať znova“: uvedie, čo sa opravilo a ako sa zmenilo skóre.

Skontrolovať moju stránku →

Súvisiace návody

Všetky zistenia a ako funguje skóre