La versió Markdown per als agents està trencada
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.
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
- Obre la URL de les proves i mira l'estat, el
Content-Typei el cos. - Si la còpia ha desaparegut, torna-la a desplegar o elimina l'etiqueta
<link rel="alternate" type="text/markdown">i la capçaleraLinkque hi apunten. - 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. - 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ó.