Geen Markdown-versie voor AI-agents

Kort antwoord

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.

agent.no_markdown · Prioriteit: 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

  1. Kies één manier om Markdown aan te bieden: beantwoord Accept: text/markdown op de eigen URL van de pagina, of publiceer een kopie zoals /guide/index.md.
  2. 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 om text/markdown vraagt.
  3. Stuur Content-Type: text/markdown; charset=utf-8 mee en, als de URL dezelfde is als die van de HTML-pagina, Vary: Accept.
  4. Link de kopie vanuit de HTML-head met <link rel="alternate" type="text/markdown">, zodat ook agents die niet onderhandelen haar vinden.
  5. 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.

Controleer mijn pagina →

Gerelateerde gidsen

Alle bevindingen en hoe de score werkt