Ingen Markdown-version til AI-agenter

Kort svar

Da siden blev hentet med Accept: text/markdown, sendte serveren HTML, og siden linker ikke til en Markdown-kopi. AI-agenter læser så hele HTML-koden, inklusive menuer, sidefødder og scripts. Det er valgfrit at tilbyde en Markdown-version: det er en ung konvention, så dette er P3.

agent.no_markdown · Prioritet: P3

Hvad det betyder

Ved en forespørgsel med Accept: text/markdown svarede siden med HTML, og den linker ikke til en Markdown-kopi (<link rel="alternate" type="text/markdown">). Agenter læser så hele HTML-koden, inklusive menuer og scripts. Valgfrit: Markdown til agenter er en ung konvention, ikke en standard.

Hvorfor det har betydning for AI-søgning

Agenter, der browser for en bruger (og værktøjer, der indlæser sider i en models kontekst), arbejder med tekst, ikke layout. En ren Markdown-version af en side er flere gange mindre end HTML-koden og bevarer de overskrifter, lister og links, der betyder noget. Nogle CDN'er og frameworks svarer allerede på Accept: text/markdown med sådan en version, og llmstxt.org foreslår en .md-kopi ved siden af hver side.

Intet går i stykker uden den: crawlere læser stadig HTML-koden. Det er en billig forbedring, når fundene om adgang, robots.txt og indhold er rettet.

Sådan retter du det

  1. Vælg én måde at levere Markdown på: svar på Accept: text/markdown på sidens egen URL, eller udgiv en kopi som /guide/index.md.
  2. På et CDN: slå dets Markdown-konvertering til agenter til, hvis den findes. I et framework: tilføj middleware, der returnerer Markdown-versionen, når headeren Accept beder om text/markdown.
  3. Send Content-Type: text/markdown; charset=utf-8 og, når URL'en er den samme som HTML-sidens, Vary: Accept.
  4. Link til kopien fra HTML-sidens head med <link rel="alternate" type="text/markdown">, så agenter, der ikke forhandler, også kan finde den.
  5. Tryk på "Tjek igen" i siderapporten for at bekræfte resultatet.

Eksempel

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

Sådan bekræfter du rettelsen

Tryk på "Tjek igen" i rapporten efter ændringen: den viser, hvad der er rettet, og hvordan scoren har ændret sig.

Tjek min side →

Relaterede vejledninger

Alle fund, og hvordan scoren virker