Ingen Markdown-version för AI-agenter
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.
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
- Välj ett sätt att leverera Markdown: svara på
Accept: text/markdownpå sidans egen URL, eller publicera en kopia som/guide/index.md. - 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
Acceptber omtext/markdown. - Skicka
Content-Type: text/markdown; charset=utf-8och, när URL:en är densamma som HTML-sidans,Vary: Accept. - 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. - 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.