La versió Markdown per als agents està trencada

Resposta breu

La pàgina ofereix una versió Markdown als agents, amb una resposta a Accept: text/markdown o amb un <link rel="alternate" type="text/markdown">, però aquesta versió retorna un error, un cos buit o una pàgina HTML. Els agents que la demanen no obtenen res útil.

agent.markdown_broken · Prioritat: P2

Què vol dir

La pàgina ofereix Markdown als agents (com a resposta a Accept: text/markdown o com a còpia enllaçada), però el que torna és un error, un cos buit o una pàgina HTML.

Per què és important per a la cerca amb IA

Un agent que veu l'enllaç Markdown o rep una resposta text/markdown s'hi refia i potser no torna a l'HTML. Una còpia trencada és pitjor que no tenir-ne cap: l'agent falla o llegeix una pàgina d'error com si fos el teu contingut.

Sol passar després d'una migració o una reconstrucció: no s'han desplegat els fitxers .md, una regla de reescriptura apunta a un camí antic o un middleware etiqueta l'HTML com a text/markdown.

Com corregir-ho

  1. Obre la URL de les proves i mira l'estat, el Content-Type i el cos.
  2. Si la còpia ha desaparegut, torna-la a desplegar o elimina l'etiqueta <link rel="alternate" type="text/markdown"> i la capçalera Link que hi apunten.
  3. Si la resposta és HTML o buida, corregeix la conversió perquè retorni el text de la pàgina en Markdown amb Content-Type: text/markdown.
  4. Fes "Torna a comprovar" a l'informe de la pàgina per confirmar el resultat.

Exemple

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

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ó.

Comprova la meva pàgina →

Guies relacionades

Totes les troballes i com funciona la puntuació