La version Markdown pour les agents est cassée

Réponse courte

La page propose une version Markdown aux agents, par une réponse à Accept: text/markdown ou un <link rel="alternate" type="text/markdown">, mais cette version renvoie une erreur, un corps vide ou une page HTML. Les agents qui la demandent n'obtiennent rien d'utile.

agent.markdown_broken · Priorité: P2

Ce que cela signifie

La page propose du Markdown aux agents (en réponse à Accept: text/markdown ou via une copie liée), mais ce qui revient est une erreur, un corps vide ou une page HTML.

Pourquoi c'est important pour la recherche IA

Un agent qui voit le lien Markdown ou reçoit une réponse text/markdown lui fait confiance et peut ne pas revenir au HTML. Une copie cassée est pire que pas de copie : l'agent échoue, ou lit une page d'erreur comme si c'était votre contenu.

Cela arrive en général après une migration ou une refonte : les fichiers .md n'ont pas été déployés, une règle de réécriture pointe vers un ancien chemin, ou un middleware étiquette le HTML comme text/markdown.

Comment corriger

  1. Ouvrez l'URL indiquée dans les preuves et regardez le statut, le Content-Type et le corps.
  2. Si la copie a disparu, redéployez-la ou supprimez la balise <link rel="alternate" type="text/markdown"> et l'en-tête Link qui pointent vers elle.
  3. Si la réponse est du HTML ou vide, corrigez la conversion pour qu'elle renvoie le texte de la page en Markdown avec Content-Type: text/markdown.
  4. Lancez « Revérifier » dans le rapport de la page pour confirmer le résultat.

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

Comment confirmer le correctif

Après la modification, cliquez sur « Revérifier » dans le rapport : il indique ce qui a été corrigé et comment le score a évolué.

Vérifier ma page →

Guides associés

Tous les constats et le fonctionnement du score