Ingen Markdown-version för AI-agenter

Kort svar

När sidan begärdes med Accept: text/markdown skickade servern HTML, och sidan länkar ingen Markdown-kopia. AI-agenter läser då hela HTML-koden, menyer, sidfötter och skript inräknade. Att erbjuda en Markdown-version är valfritt: det är en ung konvention, så detta är P3.

agent.no_markdown · Prioritet: P3

Vad det betyder

På en förfrågan med Accept: text/markdown svarade sidan med HTML, och den länkar ingen Markdown-kopia (<link rel="alternate" type="text/markdown">). Agenter läser då hela HTML-koden, menyer och skript inräknade. Valfritt: Markdown för agenter är en ung konvention, inte en standard.

Därför spelar det roll för AI-sök

Agenter som surfar åt en användare (och verktyg som laddar sidor i en modells kontext) arbetar med text, inte layout. En ren Markdown-version av en sida är flera gånger mindre än HTML-koden och behåller rubrikerna, listorna och länkarna som spelar roll. Vissa CDN:er och ramverk svarar redan på Accept: text/markdown med en sådan version, och llmstxt.org föreslår en .md-kopia bredvid varje sida.

Inget går sönder utan den: crawlers läser fortfarande HTML-koden. Det är en billig förbättring när fynden om åtkomst, robots.txt och innehåll är åtgärdade.

Så åtgärdar du det

  1. Välj ett sätt att leverera Markdown: svara på Accept: text/markdown på sidans egen URL, eller publicera en kopia som /guide/index.md.
  2. På ett CDN: slå på dess Markdown-konvertering för agenter om den finns. I ett ramverk: lägg till middleware som returnerar Markdown-versionen när headern Accept ber om text/markdown.
  3. Skicka Content-Type: text/markdown; charset=utf-8 och, när URL:en är densamma som HTML-sidans, Vary: Accept.
  4. Länka kopian från HTML-sidans head med <link rel="alternate" type="text/markdown">, så att även agenter som inte förhandlar hittar den.
  5. Kör "Kontrollera igen" i sidrapporten för att bekräfta resultatet.

Exempel

<!-- 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å bekräftar du åtgärden

Klicka på "Kontrollera igen" i rapporten efter ändringen: den visar vad som har åtgärdats och hur poängen har ändrats.

Kontrollera min sida →

Relaterade guider

Alla fynd och hur poängen fungerar