Geen Markdown-versie voor AI-agents
Op een verzoek om de pagina met Accept: text/markdown stuurde de server HTML, en de pagina linkt geen Markdown-kopie. AI-agents lezen dan de hele HTML, inclusief menu's, footers en scripts. Een Markdown-versie aanbieden is optioneel: het is een jonge conventie, dus dit is P3.
Wat het betekent
Op een verzoek met Accept: text/markdown antwoordde de pagina met HTML, en ze linkt geen Markdown-kopie (<link rel="alternate" type="text/markdown">). Agents lezen dan de hele HTML, inclusief menu's en scripts. Optioneel: Markdown voor agents is een jonge conventie, geen standaard.
Waarom het ertoe doet voor AI-zoeken
Agents die voor een gebruiker browsen (en tools die pagina's in de context van een model laden) werken met tekst, niet met opmaak. Een schone Markdown-versie van een pagina is een paar keer kleiner dan de HTML en behoudt de koppen, lijsten en links die ertoe doen. Sommige CDN's en frameworks beantwoorden Accept: text/markdown al met zo'n versie, en llmstxt.org stelt een .md-kopie naast elke pagina voor.
Zonder werkt alles nog: crawlers lezen gewoon de HTML. Het is een goedkope verbetering zodra de bevindingen over toegang, robots.txt en content zijn opgelost.
Zo los je het op
- Kies één manier om Markdown aan te bieden: beantwoord
Accept: text/markdownop de eigen URL van de pagina, of publiceer een kopie zoals/guide/index.md. - Zet op een CDN de Markdown-conversie voor agents aan als die er is. Voeg in een framework middleware toe die de Markdown-versie teruggeeft wanneer de
Accept-header omtext/markdownvraagt. - Stuur
Content-Type: text/markdown; charset=utf-8mee en, als de URL dezelfde is als die van de HTML-pagina,Vary: Accept. - Link de kopie vanuit de HTML-head met
<link rel="alternate" type="text/markdown">, zodat ook agents die niet onderhandelen haar vinden. - Voer "Opnieuw controleren" uit in het paginarapport om het resultaat te bevestigen.
Voorbeeld
<!-- 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 Hoe je de oplossing bevestigt
Klik na de wijziging op "Opnieuw controleren" in het rapport: het toont wat is opgelost en hoe de score is veranderd.