# Markdown pre AI agentov

> Markdown pre AI agentov znamená, že web vie poslať stránku ako čistý Markdown, cez adresu .md alebo content negotiation, namiesto celého HTML.

- **Číslo kontroly:** A21
- **Oblasť:** [AI Pripravenosť webu](https://be1st.ai/sk/glossary/ai-readiness)
- **Nástroj:** [AI Pripravenosť webu](https://be1st.ai/sk/tools/ai-readiness)
- **Stránka:** https://be1st.ai/sk/glossary/ai-readiness/markdown-for-ai-agents

## Prečo na tom záleží

AI agent, ktorý si stiahne HTML, musí z neho najprv odstrániť navigáciu, skripty a štýly, a minie na to násobne viac tokenov. Markdown verzia tej istej stránky býva výrazne menšia (na Cloudflare docs sme namerali úsporu cez 90 %), takže sa do kontextu modelu zmestí viac skutočného obsahu. Je to iná vec než llms.txt: llms.txt je index celého webu, toto je obsah jednej stránky.

## V praxi

developers.cloudflare.com aj docs.railway.com vrátia na požiadavku s Accept: text/markdown čistý Markdown s hlavičkou Vary: Accept, takže agent aj bežný prehliadač dostanú z tej istej adresy vhodnú podobu obsahu.

## Ako to be1st kontroluje

Kontrola, či web dokáže poskytnúť obsah konkrétnej stránky priamo vo formáte Markdown. Testuje sa content negotiation (požiadavka s hlavičkou Accept: text/markdown), Markdown alternatíva cez `<link rel="alternate">` alebo HTTP Link hlavičku, a existencia .md verzie stránky. Obsah odpovede sa overuje, aby sa HTML vydávané za Markdown nepočítalo.

[AI Pripravenosť webu](https://be1st.ai/sk/tools/ai-readiness), záložka Formáty.

Každá kontrola skončí ako: V poriadku, Varovanie, Chyba.

## Zdroje

- [Markdown for Agents](https://developers.cloudflare.com/workers-ai/features/markdown-conversion/) (Cloudflare)
- [HTTP Content Negotiation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Content_negotiation) (MDN)

## Súvisiace pojmy

- [Existencia llms.txt](https://be1st.ai/sk/glossary/ai-readiness/llms-txt-existence): llms.txt je súbor v Markdowne v koreni webu, ktorý AI modelom dá stručný prehľad o webe a odkazy na jeho najdôležitejšie stránky.
- [Pomlčky v texte (stopa AI)](https://be1st.ai/sk/glossary/ai-readiness/dashes-in-text): Dlhé pomlčky v texte (em dash a en dash mimo číselných rozsahov) sú najznámejšou stopou textu, ktorý napísal jazykový model.
- [Schéma Organization](https://be1st.ai/sk/glossary/ai-readiness/organization-schema): Schéma Organization sú štruktúrované dáta Schema.org, ktoré opisujú firmu za webom: jej názov, logo, kontakty a profily na sociálnych sieťach.
- [Schéma Product](https://be1st.ai/sk/glossary/ai-readiness/product-schema): Schéma Product sú štruktúrované dáta Schema.org, ktoré opisujú produkt alebo službu: názov, cenu, dostupnosť a recenzie.
- [Schéma FAQ](https://be1st.ai/sk/glossary/ai-readiness/faq-schema): Schéma FAQ sú štruktúrované dáta Schema.org (FAQPage), ktoré strojovo čitateľne označia otázky a odpovede na stránke.
- [Schéma Review a Rating](https://be1st.ai/sk/glossary/ai-readiness/review-rating-schema): Schémy Review a AggregateRating sú štruktúrované dáta Schema.org, ktoré opisujú recenzie a priemerné hodnotenie produktu alebo služby.