Docs

Conviene servire le pagine in Markdown agli agenti AI (llms.txt, Markdown for Agents)?

Facoltativo, e mai al posto di un buon HTML. Google dice che per comparire nella Ricerca Google non servono Markdown né file di testo per l'AI, e le sue funzioni AI leggono le stesse pagine HTML. Una versione Markdown aiuta gli agenti che la chiedono, come Claude Code, a leggere la tua pagina con meno token. Se ne aggiungi una, deve dire esattamente ciò che dice la pagina HTML.

Dati

Chi legge davvero la versione Markdown?

Soprattutto gli agenti di codifica e gli strumenti AI che scaricano una pagina su richiesta, non i crawler dei motori di ricerca che decidono cosa viene citato.

LettoreCosa leggeIl Markdown aiuta?
Google Search, AI Overview, AI ModeLe tue pagine HTMLNo: Google dice che non ha bisogno del Markdown
Agenti di codifica come Claude CodeIl Markdown, se il sito lo offre con Accept: text/markdownSì: meno token, testo più pulito
Lettori della documentazione per sviluppatoriUna copia .md di ogni paginaSì: la documentazione per sviluppatori di OpenAI ne offre una aggiungendo .md all'URL
llms.txtUn file indice breveNon per la Ricerca Google, che lo ignora

Servire il Markdown ai bot è cloaking?

Non se il contenuto è lo stesso. Google definisce cloaking mostrare contenuti diversi a utenti e motori di ricerca con l'intento di manipolare i ranking e ingannare gli utenti.

Una copia Markdown che riporta lo stesso testo, gli stessi prezzi e le stesse affermazioni della pagina HTML è un formato diverso, non un contenuto diverso. Il rischio è una pagina Markdown con affermazioni in più scritte per l'AI.

Dovrebbe farlo un sito aziendale o solo i siti di documentazione?

Guadagnano di più la documentazione e gli strumenti per sviluppatori, perché i loro lettori sono spesso agenti di codifica. Un sito aziendale che vende a persone ottiene di più da pagine HTML complete, renderizzate sul server, che rispondono alle domande dell'acquirente.

Se il sito è già su Cloudflare con un piano a pagamento, attivare la funzione è un interruttore e non costa nulla in più. Creare e mantenere a mano una seconda copia di ogni pagina raramente vale la pena.

Come verifico cosa riceve un agente?

Richiedi la pagina con l'intestazione Accept per il Markdown e leggi le intestazioni che tornano. La risposta deve dire content-type: text/markdown e vary: accept, così le cache tengono separate le due versioni.

# Cosa riceve un agente che chiede il Markdown
curl -s -H "Accept: text/markdown" https://www.example.com/pricing | head -20

# Le intestazioni che devono tornare insieme
curl -sI -H "Accept: text/markdown" https://www.example.com/pricing | grep -i -E "content-type|vary"
# atteso: content-type: text/markdown ... e vary: accept

Come tratta easyIndex il Markdown?

easyIndex controlla ogni pagina quando il tuo agente di codifica la invia, poi verifica la pagina HTML pubblicata sul sito online, perché è quella che leggono i crawler dei motori di ricerca e dell'AI. La pagina viene scritta una sola volta, per l'indicizzazione, quindi non esiste una seconda versione che possa divergere.

Passo dopo passo

  1. Sistema prima l'HTML. Assicurati che ogni pagina pubblica abbia tutto il testo nell'HTML renderizzato sul server e sia nella sitemap.
  2. Decidi chi ha bisogno del Markdown. Aggiungi una versione Markdown solo se agenti di codifica o sviluppatori leggono le tue pagine, come nel caso di documentazione o API.
  3. Scegli un metodo. Attiva Markdown for Agents di Cloudflare, oppure fai in modo che il tuo agente di codifica serva lo stesso contenuto in Markdown con Accept: text/markdown.
  4. Mantieni il contenuto identico. Genera il Markdown dalla stessa fonte dell'HTML, così prezzi e affermazioni non divergono mai.
  5. Prova con curl. Richiedi una pagina con Accept: text/markdown e controlla che tornino content-type e vary: accept.

Errori comuni

  • Scrivere pagine Markdown con affermazioni che non compaiono nella pagina HTML, ciò che Google chiama cloaking.
  • Creare copie Markdown mentre le pagine HTML mostrano il testo solo nel browser.
  • Servire il Markdown sullo stesso URL senza vary: accept, così una cache consegna il Markdown ai browser.
  • Aspettarsi che un file llms.txt o le copie Markdown alzino i ranking su Google, che dice di ignorarli.

Come lo risolve easyIndex

Il tuo agente di codifica scrive e pubblica ogni pagina nel tuo repository, guidato via MCP con le regole attuali; easyIndex la controlla quando viene inviata, verifica da sé l'HTML pubblicato e poi mostra quali pagine leggono i crawler AI e quante visite da assistenti AI porta ciascuna. US$ 30 per sito al mese, con una prova gratuita di 7 giorni.

Domande frequenti

Markdown for Agents è lo stesso di llms.txt?

No. llms.txt è un unico file indice nella radice del sito; Markdown for Agents restituisce una versione Markdown di qualunque pagina quando la richiesta chiede text/markdown.

Markdown for Agents funziona con il piano gratuito di Cloudflare?

No. La documentazione di Cloudflare elenca i piani Pro, Business ed Enterprise e i clienti SSL for SaaS, senza costi extra.

ChatGPT citerà di più il mio sito se servo il Markdown?

Nessuno l'ha dimostrato. La documentazione dei crawler di OpenAI non dice nulla sul Markdown, e le citazioni dipendono dal fatto che la pagina sia scansionabile e risponda alla domanda.

Il mio agente di codifica può costruirlo senza Cloudflare?

Sì. Una route o un middleware può restituire lo stesso contenuto in Markdown quando l'intestazione Accept lo chiede, con vary: accept nella risposta.

Continua a leggere

Verificato il .

Markdown per gli agenti AI? llms.txt vs Markdown for Agents