Nincs Markdown-változat az AI-ügynököknek

Rövid válasz

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.

agent.no_markdown · Prioritás: 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ó

  1. Válasszon egy módot a Markdown kiszolgálására: válaszoljon az Accept: text/markdown kérésre az oldal saját URL-jén, vagy tegyen közzé egy másolatot, például /guide/index.md.
  2. 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 Accept fejléc text/markdown formátumot kér.
  3. Küldjön Content-Type: text/markdown; charset=utf-8 fejlécet, és ha az URL megegyezik a HTML-oldaléval, Vary: Accept fejlécet is.
  4. 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.
  5. 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.

Ellenőrizze az oldalamat →

Kapcsolódó útmutatók

Minden találat és a pontszám működése