Docs

Vale a pena servir versões em Markdown das minhas páginas para agentes de IA (llms.txt)?

É opcional e nunca substitui um bom HTML. O Google diz que você não precisa de Markdown nem de arquivos de texto para IA para aparecer na Busca, e os recursos de IA dele leem as mesmas páginas HTML. Uma versão em Markdown ajuda agentes que pedem esse formato, como o Claude Code, a ler a página com menos tokens. Se fizer, ela deve dizer o mesmo que o HTML.

Fatos

Quem lê de fato a versão em Markdown?

Principalmente agentes de código e ferramentas de IA que buscam uma página a pedido do usuário, não os rastreadores de busca que decidem o que é citado.

Quem lêO que lêMarkdown ajuda?
Busca do Google, AI Overviews, Modo IAAs páginas HTMLNão: o Google diz que não precisa de Markdown
Agentes de código como o Claude CodeMarkdown quando o site oferece no Accept: text/markdownSim: menos tokens, texto mais limpo
Quem lê documentação técnicaUma cópia .md de cada páginaSim: a própria documentação para desenvolvedores da OpenAI oferece isso ao somar .md à URL
llms.txtUm arquivo curto de índiceNão para a Busca do Google, que ignora o arquivo

Servir Markdown para robôs é cloaking?

Não, se o conteúdo for o mesmo. O Google define cloaking como mostrar conteúdo diferente para usuários e mecanismos de busca com a intenção de manipular o ranking e enganar quem lê.

Uma cópia em Markdown com o mesmo texto, os mesmos preços e as mesmas promessas do HTML é outro formato, não outro conteúdo. O risco é uma página em Markdown com afirmações a mais escritas só para a IA.

Meu site de empresa precisa disso ou só sites de documentação?

Documentação e ferramentas para desenvolvedores ganham mais, porque quem lê costuma ser um agente de código. Um site que vende para pessoas ganha mais com páginas HTML completas, renderizadas no servidor, que respondem às perguntas de quem compra.

Se o site já está atrás da Cloudflare num plano pago, ligar o recurso é um botão e não custa nada a mais. Montar e manter à mão uma segunda cópia de cada página raramente compensa.

Como confiro o que um agente recebe?

Peça a página com o cabeçalho Accept de Markdown e leia os cabeçalhos da resposta. Ela tem que trazer content-type: text/markdown e vary: accept, para o cache não misturar as duas versões.

# What an agent that asks for Markdown receives
curl -s -H "Accept: text/markdown" https://www.example.com/pricing | head -20

# The headers that must come back with it
curl -sI -H "Accept: text/markdown" https://www.example.com/pricing | grep -i -E "content-type|vary"
# expected: content-type: text/markdown ... and vary: accept

Como o easyIndex trata o Markdown?

O easyIndex audita cada página quando o seu agente de código envia, e depois confere a página HTML publicada no site em produção, porque é isso que os rastreadores de busca e de IA leem. A página é escrita uma vez, para indexação, então não existe segunda versão para sair do compasso.

Passo a passo

  1. Arrume o HTML primeiro. Garanta que cada página pública tem o texto completo no HTML renderizado no servidor e está no sitemap.
  2. Veja quem precisa de Markdown. Só crie a versão em Markdown se agentes de código ou desenvolvedores leem suas páginas, como em documentação ou APIs.
  3. Escolha um jeito só. Ligue o Markdown for Agents da Cloudflare, ou peça ao seu agente de código para servir o mesmo conteúdo em Markdown no Accept: text/markdown.
  4. Mantenha o conteúdo idêntico. Gere o Markdown da mesma fonte do HTML para preços e promessas nunca divergirem.
  5. Teste com curl. Peça uma página com Accept: text/markdown e confirme que voltam content-type e vary: accept.

Erros comuns

  • Escrever páginas em Markdown com afirmações que não estão no HTML, o que o Google chama de cloaking.
  • Criar cópias em Markdown enquanto as páginas HTML ainda montam o texto só no navegador.
  • Servir Markdown na mesma URL sem vary: accept, e o cache entregar Markdown para o navegador.
  • Esperar que um llms.txt ou cópias em Markdown subam o ranking no Google, que diz ignorar esses arquivos.

Como o easyIndex resolve

O seu agente de código escreve e publica cada página no seu repositório, guiado via MCP com as regras atuais; o easyIndex audita quando ela é enviada, confere ele mesmo a página HTML em produção e depois mostra quais páginas os rastreadores de IA leram e quantos visitantes de assistentes de IA cada uma trouxe. R$ 57 por site por mês, com 7 dias grátis.

Perguntas frequentes

O Markdown for Agents é a mesma coisa que o llms.txt?

Não. O llms.txt é um arquivo de índice na raiz do site; o Markdown for Agents devolve uma versão em Markdown de qualquer página quando o pedido aceita text/markdown.

O Markdown for Agents funciona no plano grátis da Cloudflare?

Não. A documentação da Cloudflare lista os planos Pro, Business e Enterprise e clientes de SSL for SaaS, sem custo a mais.

O ChatGPT vai citar mais meu site se eu servir Markdown?

Ninguém mostrou isso. A documentação dos rastreadores da OpenAI não fala de Markdown, e a citação depende de a página ser rastreável e responder à pergunta.

Meu agente de código consegue fazer isso sem a Cloudflare?

Sim. Uma rota ou um middleware pode devolver o mesmo conteúdo em Markdown quando o cabeçalho Accept pedir, com vary: accept na resposta.

Continue lendo

Verificado em .

Servir Markdown para agentes de IA? llms.txt e Cloudflare