Ingen Markdown-versjon for AI-agenter
Da siden ble hentet med Accept: text/markdown, sendte serveren HTML, og siden lenker ikke til noen Markdown-kopi. AI-agenter leser da hele HTML-koden, menyer, bunntekster og skript inkludert. Å tilby en Markdown-versjon er valgfritt: det er en ung konvensjon, så dette er P3.
Hva det betyr
På en forespørsel med Accept: text/markdown svarte siden med HTML, og den lenker ikke til noen Markdown-kopi (<link rel="alternate" type="text/markdown">). Agenter leser da hele HTML-koden, menyer og skript inkludert. Valgfritt: Markdown for agenter er en ung konvensjon, ikke en standard.
Hvorfor det betyr noe for AI-søk
Agenter som surfer for en bruker (og verktøy som laster sider inn i konteksten til en modell), jobber med tekst, ikke layout. En ren Markdown-versjon av en side er flere ganger mindre enn HTML-koden og beholder overskriftene, listene og lenkene som betyr noe. Noen CDN-er og rammeverk svarer allerede på Accept: text/markdown med en slik versjon, og llmstxt.org foreslår en .md-kopi ved siden av hver side.
Ingenting går i stykker uten den: crawlere leser fortsatt HTML-koden. Det er en billig forbedring når funnene om tilgang, robots.txt og innhold er rettet.
Slik retter du det
- Velg én måte å levere Markdown på: svar på
Accept: text/markdownpå sidens egen URL, eller publiser en kopi som/guide/index.md. - På en CDN: slå på Markdown-konverteringen for agenter hvis den finnes. I et rammeverk: legg til middleware som returnerer Markdown-versjonen når
Accept-headeren ber omtext/markdown. - Send
Content-Type: text/markdown; charset=utf-8og, når URL-en er den samme som for HTML-siden,Vary: Accept. - Lenk til kopien fra head i HTML-siden med
<link rel="alternate" type="text/markdown">, slik at også agenter som ikke forhandler, finner den. - Kjør «Sjekk på nytt» i siderapporten for å bekrefte 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 Slik bekrefter du rettelsen
Trykk på "Sjekk på nytt" i rapporten etter endringen: den viser hva som er rettet og hvordan scoren har endret seg.