Sin versión Markdown para agentes de IA
Al pedir la página con Accept: text/markdown, el servidor envió HTML, y la página no enlaza ninguna copia en Markdown. Los agentes de IA leen entonces todo el HTML, menús, pies de página y scripts incluidos. Servir una versión Markdown es opcional: es una convención reciente, por eso es P3.
Qué significa
Al pedirla con Accept: text/markdown, la página respondió con HTML y no enlaza ninguna copia en Markdown (<link rel="alternate" type="text/markdown">). Los agentes leen entonces todo el HTML, menús y scripts incluidos. Opcional: el Markdown para agentes es una convención reciente, no un estándar.
Por qué importa para la búsqueda con IA
Los agentes que navegan para un usuario (y las herramientas que cargan páginas en el contexto de un modelo) trabajan con texto, no con el diseño. Una versión Markdown limpia de una página pesa varias veces menos que su HTML y conserva los encabezados, listas y enlaces que importan. Algunas CDN y frameworks ya responden a Accept: text/markdown con una versión así, y llmstxt.org propone una copia .md junto a cada página.
Sin ella no se rompe nada: los rastreadores siguen leyendo el HTML. Es una mejora barata una vez resueltos los hallazgos de acceso, robots.txt y contenido.
Cómo corregirlo
- Elija una forma de servir Markdown: responder a
Accept: text/markdownen la propia URL de la página, o publicar una copia como/guide/index.md. - En una CDN, active su conversión a Markdown para agentes si la tiene. En un framework, añada un middleware que devuelva la versión Markdown cuando la cabecera
Acceptpidatext/markdown. - Envíe
Content-Type: text/markdown; charset=utf-8y, cuando la URL sea la misma que la de la página HTML,Vary: Accept. - Enlace la copia desde el head del HTML con
<link rel="alternate" type="text/markdown">, para que también la encuentren los agentes que no negocian el contenido. - Pulse «Volver a comprobar» en el informe de la página para confirmar el resultado.
Ejemplo
<!-- 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 Cómo confirmar la corrección
Después del cambio, pulse «Volver a comprobar» en el informe: muestra qué se corrigió y cómo cambió la puntuación.