La versión Markdown para agentes está rota
La página ofrece una versión Markdown a los agentes, mediante una respuesta a Accept: text/markdown o un <link rel="alternate" type="text/markdown">, pero esa versión devuelve un error, un cuerpo vacío o una página HTML. Los agentes que la piden no obtienen nada útil.
Qué significa
La página ofrece Markdown a los agentes (como respuesta a Accept: text/markdown o como copia enlazada), pero lo que devuelve es un error, un cuerpo vacío o una página HTML.
Por qué importa para la búsqueda con IA
Un agente que ve el enlace Markdown o recibe una respuesta text/markdown confía en ella y puede no volver al HTML. Una copia rota es peor que ninguna: el agente falla o lee una página de error como si fuera su contenido.
Suele ocurrir tras una migración o una reconstrucción del sitio: los archivos .md no se desplegaron, una regla de reescritura apunta a una ruta antigua o un middleware etiqueta el HTML como text/markdown.
Cómo corregirlo
- Abra la URL de la evidencia y revise el estado, el
Content-Typey el cuerpo. - Si la copia ya no existe, vuelva a desplegarla o elimine la etiqueta
<link rel="alternate" type="text/markdown">y la cabeceraLinkque apuntan a ella. - Si la respuesta es HTML o está vacía, corrija la conversión para que devuelva el texto de la página en Markdown con
Content-Type: text/markdown. - Pulse «Volver a comprobar» en el informe de la página para confirmar el resultado.
Ejemplo
curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, 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.