La versión Markdown para agentes está rota

Respuesta breve

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.

agent.markdown_broken · Prioridad: P2

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

  1. Abra la URL de la evidencia y revise el estado, el Content-Type y el cuerpo.
  2. Si la copia ya no existe, vuelva a desplegarla o elimine la etiqueta <link rel="alternate" type="text/markdown"> y la cabecera Link que apuntan a ella.
  3. 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.
  4. 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.

Comprobar mi página →

Guías relacionadas

Todos los hallazgos y cómo funciona la puntuación