Ni različice v Markdownu za agente UI

Kratek odgovor

Na zahtevo za stran z Accept: text/markdown je strežnik poslal HTML, stran pa ne povezuje na kopijo v Markdownu. Agenti UI zato berejo ves HTML, skupaj z meniji, nogami in skriptami. Različica v Markdownu je neobvezna: gre za mlado konvencijo, zato je to P3.

agent.no_markdown · Prioriteta: P3

Kaj pomeni

Na zahtevo z Accept: text/markdown je stran odgovorila s HTML in ne povezuje na kopijo v Markdownu (<link rel="alternate" type="text/markdown">). Agenti zato berejo ves HTML, skupaj z meniji in skriptami. Neobvezno: Markdown za agente je mlada konvencija, ne standard.

Zakaj je to pomembno za iskanje z UI

Agenti, ki brskajo namesto uporabnika (in orodja, ki nalagajo strani v kontekst modela), delajo z besedilom, ne s postavitvijo. Čista različica strani v Markdownu je nekajkrat manjša od njenega HTML in ohrani naslove, sezname in povezave, ki štejejo. Nekateri CDN-ji in ogrodja že odgovarjajo na Accept: text/markdown s tako različico, llmstxt.org pa predlaga kopijo .md ob vsaki strani.

Brez nje se nič ne pokvari: pajki še vedno berejo HTML. To je poceni izboljšava, ko so ugotovitve o dostopu, robots.txt in vsebini že odpravljene.

Kako to popraviti

  1. Izberite en način streženja Markdowna: odgovarjajte na Accept: text/markdown na URL-ju same strani ali objavite kopijo, na primer /guide/index.md.
  2. Če ima vaš CDN pretvorbo v Markdown za agente, jo vklopite. V ogrodju dodajte vmesno programsko opremo (middleware), ki vrne različico v Markdownu, ko glava Accept zahteva text/markdown.
  3. Pošiljajte Content-Type: text/markdown; charset=utf-8 in, kadar je URL enak kot pri strani HTML, tudi Vary: Accept.
  4. Kopijo povežite iz glave HTML z <link rel="alternate" type="text/markdown">, da jo najdejo tudi agenti, ki se o formatu ne pogajajo.
  5. V poročilu strani zaženite „Preveri znova“, da potrdite rezultat.

Primer

<!-- 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

Kako potrditi popravek

Po spremembi v poročilu pritisnite »Preveri znova«: pokaže, kaj je odpravljeno in kako se je spremenila ocena.

Preveri mojo stran →

Sorodni vodniki

Vse ugotovitve in kako deluje ocena