Ingen Markdown-version til AI-agenter
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.
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
- Vælg én måde at levere Markdown på: svar på
Accept: text/markdownpå sidens egen URL, eller udgiv en kopi som/guide/index.md. - 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
Acceptbeder omtext/markdown. - Send
Content-Type: text/markdown; charset=utf-8og, når URL'en er den samme som HTML-sidens,Vary: Accept. - Link til kopien fra HTML-sidens head med
<link rel="alternate" type="text/markdown">, så agenter, der ikke forhandler, også kan finde den. - 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.