Nincs Markdown-változat az AI-ügynököknek
Amikor az oldalt Accept: text/markdown fejléccel kérték, a szerver HTML-t küldött, és az oldal nem hivatkozik Markdown-másolatra. Az AI-ügynökök így a teljes HTML-t olvassák, menükkel, láblécekkel és szkriptekkel együtt. A Markdown-változat nem kötelező: fiatal konvenció, ezért ez P3.
Mit jelent
Accept: text/markdown kérésre az oldal HTML-lel válaszolt, és nem hivatkozik Markdown-másolatra (<link rel="alternate" type="text/markdown">). Az ügynökök így a teljes HTML-t olvassák, menükkel és szkriptekkel együtt. Nem kötelező: az ügynököknek szánt Markdown fiatal konvenció, nem szabvány.
Miért fontos az AI-keresésben
A felhasználó helyett böngésző ügynökök (és a weboldalakat a modell kontextusába töltő eszközök) szöveggel dolgoznak, nem elrendezéssel. Egy tiszta Markdown-változat a HTML-nél többszörösen kisebb, és megtartja a fontos címsorokat, listákat és linkeket. Egyes CDN-ek és keretrendszerek már ilyen változattal válaszolnak az Accept: text/markdown kérésre, az llmstxt.org pedig minden oldal mellé egy .md másolatot javasol.
Nélküle semmi sem romlik el: a crawlerek továbbra is a HTML-t olvassák. Olcsó javítás, miután a hozzáférési, robots.txt és tartalmi találatokat már rendbe tette.
Hogyan javítható
- Válasszon egy módot a Markdown kiszolgálására: válaszoljon az
Accept: text/markdownkérésre az oldal saját URL-jén, vagy tegyen közzé egy másolatot, például/guide/index.md. - CDN esetén kapcsolja be az ügynököknek szóló Markdown-konverziót, ha van ilyen. Keretrendszerben adjon hozzá egy middleware-t, amely a Markdown-változatot adja vissza, ha az
Acceptfejléctext/markdownformátumot kér. - Küldjön
Content-Type: text/markdown; charset=utf-8fejlécet, és ha az URL megegyezik a HTML-oldaléval,Vary: Acceptfejlécet is. - Hivatkozzon a másolatra a HTML head részéből a
<link rel="alternate" type="text/markdown">elemmel, hogy a tartalomegyeztetést nem használó ügynökök is megtalálják. - Az oldaljelentésen futtassa az „Újraellenőrzés” funkciót az eredmény megerősítéséhez.
Példa
<!-- 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 Hogyan győződhet meg a javításról
A módosítás után kattintson a jelentésben az „Újraellenőrzés” gombra: látni fogja, mi javult, és hogyan változott a pontszám.