Chybí verze v Markdownu pro AI agenty

Stručná odpověď

Na požadavek na stránku s Accept: text/markdown server poslal HTML a stránka neodkazuje na žádnou kopii v Markdownu. AI agenti pak čtou celé HTML včetně menu, patiček a skriptů. Verze v Markdownu je volitelná: jde o mladou konvenci, proto je to P3.

agent.no_markdown · Priorita: P3

Co to znamená

Na požadavek s Accept: text/markdown stránka odpověděla HTML a neodkazuje na žádnou kopii v Markdownu (<link rel="alternate" type="text/markdown">). Agenti pak čtou celé HTML včetně menu a skriptů. Volitelné: Markdown pro agenty je mladá konvence, ne standard.

Proč na tom záleží pro AI vyhledávání

Agenti, kteří procházejí web za uživatele (a nástroje, které načítají stránky do kontextu modelu), pracují s textem, ne s rozvržením. Čistá verze stránky v Markdownu je několikrát menší než její HTML a zachovává nadpisy, seznamy a odkazy, na kterých záleží. Některá CDN a frameworky už na Accept: text/markdown takovou verzí odpovídají a llmstxt.org navrhuje kopii .md vedle každé stránky.

Bez ní se nic nerozbije: crawlery dál čtou HTML. Je to levné vylepšení, jakmile jsou opravena zjištění k přístupu, robots.txt a obsahu.

Jak to opravit

  1. Zvolte jeden způsob, jak Markdown podávat: odpovídejte na Accept: text/markdown na vlastní URL stránky, nebo zveřejněte kopii, například /guide/index.md.
  2. Pokud vaše CDN umí převod do Markdownu pro agenty, zapněte ho. Ve frameworku přidejte middleware, který vrátí verzi v Markdownu, když hlavička Accept žádá text/markdown.
  3. Posílejte Content-Type: text/markdown; charset=utf-8 a pokud je URL stejná jako u stránky HTML, také Vary: Accept.
  4. Odkažte na kopii z hlavičky HTML pomocí <link rel="alternate" type="text/markdown">, aby ji našli i agenti, kteří formát nevyjednávají.
  5. Na reportu stránky spusťte „Zkontrolovat znovu“ a ověřte výsledek.

Pří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

Jak ověřit opravu

Po změně klikněte ve zprávě na „Zkontrolovat znovu“: uvidíte, co bylo opraveno a jak se změnilo skóre.

Zkontrolovat mou stránku →

Související návody

Všechna zjištění a jak funguje skóre