Ingen Markdown-versjon for AI-agenter

Kort svar

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.

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

  1. Velg én måte å levere Markdown på: svar på Accept: text/markdown på sidens egen URL, eller publiser en kopi som /guide/index.md.
  2. 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 om text/markdown.
  3. Send Content-Type: text/markdown; charset=utf-8 og, når URL-en er den samme som for HTML-siden, Vary: Accept.
  4. Lenk til kopien fra head i HTML-siden med <link rel="alternate" type="text/markdown">, slik at også agenter som ikke forhandler, finner den.
  5. 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.

Sjekk siden min →

Relaterte veiledninger

Alle funn og hvordan scoren fungerer