--- title: "Markdown for Agents da Cloudflare: o que é e quando usar | Grupo Marfre" description: "Markdown for Agents da Cloudflare converte HTML em Markdown para quem pede Accept: text/markdown. Veja planos, limites e quando o espelho gerado é melhor." canonical: https://grupomarfre.com.br/sites-agenticos/markdown-for-agents-cloudflare/ alternate_html: https://grupomarfre.com.br/sites-agenticos/markdown-for-agents-cloudflare/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Markdown for Agents da Cloudflare: o que é e quando usar **Resposta rápida:** O Markdown for Agents é um recurso beta da Cloudflare que converte o HTML do site em Markdown na borda, quando o pedido manda Accept: text/markdown. Está sem custo nos planos Pro, Business e Enterprise. Serve para sites que não conseguem montar uma camada própria, mas só converte HTML e não substitui um espelho gerado da mesma fonte. O Markdown for Agents é um recurso da Cloudflare, ainda em beta, que entrega uma versão em Markdown de cada página HTML sem você escrever código. Quando um agente de IA pede a página com o cabeçalho `Accept: text/markdown`, a Cloudflare converte o HTML na borda e responde em Markdown. Quem pede HTML continua recebendo HTML. Ele resolve um pedaço do problema: a [negociação de conteúdo](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/) para sites que não têm como mexer no servidor. Não resolve o problema inteiro. Os limites abaixo decidem se ele basta no seu caso. ## O que o Markdown for Agents faz, exatamente? Segundo a documentação da Cloudflare (atualizada em 09/10/2026), o recurso converte o HTML em Markdown na borda quando o pedido manda `Accept: text/markdown`. A conversão acontece na hora do pedido, a partir do HTML que o site já serve. Você não cria nem mantém arquivos `.md`. Isso cobre parte do que um [middleware próprio](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/) entrega (a resposta por `Accept`), só que ligado por configuração e não por código. O formato de destino é o [Markdown](https://grupomarfre.com.br/sites-agenticos/markdown/), texto limpo sem o código da página. ## Quem pode usar e onde se liga? O recurso está disponível sem custo nos planos Pro, Business e Enterprise e para quem usa SSL for SaaS. O plano gratuito não aparece nessa lista da documentação. A ativação fica na seção AI Crawl Control da zona no painel da Cloudflare. O AI Crawl Control, por sua vez, está disponível em todos os planos (documentação de 14/08/2026). Ele mostra quais serviços de IA acessam o site e permite regras de liberar ou bloquear por robô. O Pay Per Crawl, que cobra por rastreio, também fica ali e está em beta. Vale abrir essa tela antes de ligar o recurso, para ver quem já visita o site. ## Quais são os limites? Os limites que mais pesam na decisão: | Limite | O que significa na prática | | --- | --- | | Só converte HTML | Páginas que não são HTML não ganham versão em Markdown. | | Gatilho é o cabeçalho Accept | Pelo que a documentação descreve, quem não manda `Accept: text/markdown` recebe HTML. | | Não cobre user-agent de robô nem `?mode=agent` | O Grupo Marfre não testou o recurso em produção e, pela descrição da documentação, essas duas portas de entrada ficam de fora. | | Beta | O comportamento pode mudar. Releia a documentação antes de depender dele. | | Não é o espelho da mesma fonte | A conversão parte do HTML pronto, não de uma fonte que gera HTML e Markdown juntos. | O último ponto importa mais do que parece. Na régua do Grupo Marfre, o espelho `.md` sai da mesma fonte do HTML, com frontmatter YAML (title, description, canonical, alternate\_html, language, last\_updated, type). Veja como isso funciona em [espelho em Markdown de cada página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/). Na conversão automática, confira na documentação e no teste se esses campos aparecem. ## Quando vale usar o Markdown for Agents? Vale quando três condições se juntam: o site já passa pela Cloudflare em plano elegível, você não tem acesso ao código para montar uma camada própria e o objetivo é cobrir os agentes que pedem Markdown pelo cabeçalho `Accept`. Nesse cenário, ligar o recurso custa pouco e não exige deploy. Ele também serve como primeiro passo. Dá para ligar hoje, ver no AI Crawl Control quais serviços de IA acessam o site e decidir depois se vale investir em algo mais completo. Na régua do Grupo Marfre, um [site estático no Cloudflare Pages](https://grupomarfre.com.br/sites-agenticos/site-estatico-no-cloudflare-pages/) já nasce com o caminho próprio, o middleware na borda. ## Quando o espelho gerado é melhor? O espelho gerado é melhor quando você precisa de controle sobre a resposta. Na negociação de conteúdo da casa (método do Grupo Marfre), o `.md` vai a três públicos: quem manda `Accept: text/markdown`, quem acrescenta `?mode=agent` e o user-agent de robô de IA. Googlebot e Bingbot recebem o HTML, que é a canônica. Esse desenho tem peças que as fontes consultadas não mencionam no recurso da Cloudflare: 1. `Vary: Accept, Accept-Encoding, User-Agent` em toda resposta, porque a regra decide também por user-agent (veja [cabeçalho Vary](https://grupomarfre.com.br/sites-agenticos/cabecalho-vary/)). 2. Cabeçalho `Link` apontando o `.md`, o llms.txt e o sitemap. 3. `X-Robots-Tag: noindex` no `.md`, que também fica fora do sitemap para não virar conteúdo duplicado. 4. Frontmatter com canonical e data de atualização. 5. Entrada por user-agent de robô e por `?mode=agent`. Se o seu site precisa dessas peças, o espelho gerado compensa o trabalho. Se precisa só de "responder Markdown a quem pede", o recurso pode bastar. ## Como testar se está funcionando? Rode quatro pedidos com curl, trocando o domínio pelo seu (o endereço abaixo é fictício): ``` ## 1. Com Accept: o corpo deve vir em Markdown curl -s -H "Accept: text/markdown" https://www.exemplo.com.br/servicos/ | head -20 ## 2. Cabeçalhos da resposta: procure Vary: Accept curl -s -D - -o /dev/null -H "Accept: text/markdown" https://www.exemplo.com.br/servicos/ ## 3. Sem Accept, mas com user-agent de robô: veja o que volta curl -s -A "GPTBot" https://www.exemplo.com.br/servicos/ | head -20 ## 4. Com ?mode=agent: veja o que volta curl -s "https://www.exemplo.com.br/servicos/?mode=agent" | head -20 ``` O pedido 1 deve voltar Markdown. Nos pedidos 3 e 4, pela descrição da documentação, deve voltar HTML. Se voltar Markdown, outra camada está respondendo. No pedido 2, sem `Accept` no `Vary`, um cache que segue o padrão HTTP, como o do navegador, pode servir a versão errada. Outras receitas estão em [como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/). ## Perguntas frequentes ### O Markdown for Agents faz a IA citar meu site? Não há garantia. O recurso só muda o formato que o agente recebe quando pede Markdown. A escolha de citar ou não é do modelo. ### Preciso do plano pago da Cloudflare? Pela lista da documentação, o recurso está disponível sem custo nos planos Pro, Business e Enterprise e para quem usa SSL for SaaS. O plano gratuito não aparece nessa lista. O AI Crawl Control, que fica na mesma área do painel, está em todos os planos. ### Posso usar o recurso junto com um espelho próprio? As fontes consultadas não tratam dessa combinação. Se for tentar, faça os testes com curl acima e confira qual resposta chega a cada tipo de pedido. ### O recurso bloqueia ou libera robôs de IA? Não. No painel da Cloudflare, isso se faz no AI Crawl Control, com regras de liberar ou bloquear por robô, e também nas regras do firewall (WAF). O Markdown for Agents só converte o HTML quando o pedido manda `Accept: text/markdown`. ## Fontes consultadas - [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/) - [developers.cloudflare.com/ai-crawl-control/](https://developers.cloudflare.com/ai-crawl-control/) ## Leia também ### [Negociação de conteúdo: servir Markdown a quem pede Accept: text/markdown](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/) Negociação de conteúdo em Markdown: como servir o .md a quem manda Accept: text/markdown, ?mode=agent ou user-agent de IA, e testar tudo com curl. ### [Espelho em Markdown de cada página: o que é e como gerar](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/) Espelho em Markdown de cada página: o que é, como nomear o arquivo .md, gerar da mesma fonte do HTML, o que tirar e como evitar conteúdo duplicado. ### [Camada agêntica no Cloudflare Pages com Pages Functions](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/) Guia para montar a camada agêntica no Cloudflare Pages com Pages Functions (Markdown por Accept, Vary, Link, 404 em Markdown) e provar com curl. ### [Cabeçalho Vary: por que o site agêntico precisa dele](https://grupomarfre.com.br/sites-agenticos/cabecalho-vary/) Cabeçalho Vary avisa ao cache que a mesma URL tem versão HTML e Markdown. Veja o que a borda da Cloudflare respeita, quando incluir User-Agent e como conferir. ### [Como testar a camada agêntica com curl (receitas prontas)](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/) Receitas de curl para testar a camada agêntica: Accept text/markdown, ?mode=agent, GPTBot, Googlebot, Vary, Link, 404 e robots.txt, com a saída esperada. ### [Cabeçalho Link (RFC 8288): como o agente descobre a versão em Markdown](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/) Cabeçalho Link (RFC 8288): como apontar o espelho .md, o llms.txt e o sitemap por HTTP, com formato, exemplo e teste com curl, sem baixar o HTML. --- ## Sobre o Grupo Marfre Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota. - Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil - WhatsApp: (31) 93618-7272, https://wa.me/5531936187272 - E-mail: contato@grupomarfre.com.br - Instagram: https://instagram.com/marfregrupo - Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação - Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/ - Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/ - Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização - Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja - Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso - Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt Página HTML equivalente: https://grupomarfre.com.br/sites-agenticos/markdown-for-agents-cloudflare/