Nessuna versione Markdown per gli agenti AI

Risposta breve

Richiesta la pagina con Accept: text/markdown, il server ha inviato HTML, e la pagina non collega nessuna copia Markdown. Gli agenti AI leggono quindi tutto l'HTML, menu, footer e script compresi. Servire una versione Markdown è facoltativo: è una convenzione recente, per questo è P3.

agent.no_markdown · Priorità: P3

Cosa significa

Richiesta con Accept: text/markdown, la pagina ha risposto in HTML e non collega nessuna copia Markdown (<link rel="alternate" type="text/markdown">). Gli agenti leggono quindi tutto l'HTML, menu e script compresi. Facoltativo: il Markdown per gli agenti è una convenzione recente, non uno standard.

Perché conta per la ricerca AI

Gli agenti che navigano per un utente (e gli strumenti che caricano pagine nel contesto di un modello) lavorano con il testo, non con il layout. Una versione Markdown pulita di una pagina è diverse volte più leggera del suo HTML e mantiene titoli, elenchi e link che contano. Alcune CDN e alcuni framework rispondono già ad Accept: text/markdown con una versione del genere, e llmstxt.org suggerisce una copia .md accanto a ogni pagina.

Senza non si rompe nulla: i crawler continuano a leggere l'HTML. È un miglioramento economico, una volta risolti i problemi di accesso, robots.txt e contenuto.

Come risolvere

  1. Scegli un modo per servire il Markdown: rispondere ad Accept: text/markdown allo stesso URL della pagina, oppure pubblicare una copia come /guide/index.md.
  2. Su una CDN, attiva la sua conversione in Markdown per gli agenti, se ce l'ha. In un framework, aggiungi un middleware che restituisca la versione Markdown quando l'header Accept chiede text/markdown.
  3. Invia Content-Type: text/markdown; charset=utf-8 e, quando l'URL è lo stesso della pagina HTML, Vary: Accept.
  4. Collega la copia dall'head HTML con <link rel="alternate" type="text/markdown">, così la trovano anche gli agenti che non negoziano il contenuto.
  5. Esegui «Ricontrolla» sul report della pagina per confermare il risultato.

Esempio

<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">

# the Markdown answer
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