La versione Markdown per gli agenti non funziona

Risposta breve

La pagina offre agli agenti una versione Markdown, tramite una risposta ad Accept: text/markdown o un <link rel="alternate" type="text/markdown">, ma quella versione restituisce un errore, un corpo vuoto o una pagina HTML. Gli agenti che la chiedono non ottengono niente di utile.

agent.markdown_broken · Priorità: P2

Cosa significa

La pagina offre Markdown agli agenti (come risposta ad Accept: text/markdown o come copia collegata), ma quello che torna indietro è un errore, un corpo vuoto o una pagina HTML.

Perché conta per la ricerca AI

Un agente che vede il link Markdown o riceve una risposta text/markdown se ne fida e potrebbe non tornare all'HTML. Una copia rotta è peggio di nessuna copia: l'agente fallisce, oppure legge una pagina di errore come se fosse il tuo contenuto.

Di solito succede dopo una migrazione o una ricostruzione del sito: i file .md non sono stati pubblicati, una regola di rewrite punta a un vecchio percorso, oppure un middleware etichetta l'HTML come text/markdown.

Come risolvere

  1. Apri l'URL indicato nelle prove e guarda lo stato, il Content-Type e il corpo.
  2. Se la copia non c'è più, pubblicala di nuovo oppure rimuovi il tag <link rel="alternate" type="text/markdown"> e l'header Link che puntano a essa.
  3. Se la risposta è HTML o vuota, correggi la conversione in modo che restituisca il testo della pagina in Markdown con Content-Type: text/markdown.
  4. Esegui «Ricontrolla» sul report della pagina per confermare il risultato.

Esempio

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

Come confermare la correzione

Dopo la modifica, premi «Ricontrolla» nel report: mostra cosa è stato risolto e come è cambiato il punteggio.

Controlla la mia pagina →

Guide correlate

Tutti i riscontri e come funziona il punteggio