No hi ha versió Markdown per als agents d'IA
Quan s'ha demanat la pàgina amb Accept: text/markdown, el servidor ha enviat HTML, i la pàgina no enllaça cap còpia Markdown. Llavors els agents d'IA llegeixen tot l'HTML, menús, peus de pàgina i scripts inclosos. Servir una versió Markdown és opcional: és una convenció jove, així que és P3.
Què vol dir
Amb Accept: text/markdown, la pàgina ha respost amb HTML i no enllaça cap còpia Markdown (<link rel="alternate" type="text/markdown">). Llavors els agents llegeixen tot l'HTML, menús i scripts inclosos. Opcional: el Markdown per a agents és una convenció jove, no un estàndard.
Per què és important per a la cerca amb IA
Els agents que naveguen per a un usuari (i les eines que carreguen pàgines al context d'un model) treballen amb text, no amb disseny. Una versió Markdown neta d'una pàgina és diverses vegades més petita que el seu HTML i conserva els encapçalaments, les llistes i els enllaços que importen. Alguns CDN i frameworks ja responen Accept: text/markdown amb una versió així, i llmstxt.org suggereix una còpia .md al costat de cada pàgina.
Sense ella no es trenca res: els rastrejadors continuen llegint l'HTML. És una millora barata un cop corregides les troballes d'accés, de robots.txt i de contingut.
Com corregir-ho
- Tria una manera de servir Markdown: respon
Accept: text/markdowna la mateixa URL de la pàgina, o publica una còpia com/guide/index.md. - En un CDN, activa la seva conversió a Markdown per a agents si en té. En un framework, afegeix un middleware que retorni la versió Markdown quan la capçalera
Acceptdemanitext/markdown. - Envia
Content-Type: text/markdown; charset=utf-8i, quan la URL és la mateixa que la de la pàgina HTML,Vary: Accept. - Enllaça la còpia des del head de l'HTML amb
<link rel="alternate" type="text/markdown">, perquè també la trobin els agents que no negocien el format. - Fes "Torna a comprovar" a l'informe de la pàgina per confirmar el resultat.
Exemple
<!-- 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 Com confirmar la correcció
Després del canvi, prem «Torna a comprovar» a l'informe: mostra què s'ha corregit i com ha canviat la puntuació.