Markdown para Agentes da Cloudflare torna sites prontos para IA

Cloudflare, a respeitada empresa de segurança e Rede de Distribuição de Conteúdo, lançou um novo recurso chamado “Markdown para Agentes” que converte automaticamente páginas da web de HTML para Markdown sempre que agentes de IA as solicitam — reduzindo o uso de tokens em até 80 por cento.

Por quê? Os grandes modelos de linguagem (LLMs) não conseguem ler HTML? Claro que conseguem, mas do ponto de vista de um modelo, HTML é um ruído caro.

Uma página da web típica inclui formatação HTML como divs, além de scripts e outros conteúdos, que se tornam tokens que o modelo deve então “pagar” para ler. Os LLMs não se importam com essa marcação ao redor do texto. No final, isso apenas consome tokens extras.  

Quão ruim é isso? O próprio post do blog da Cloudflare anunciando essa novidade, quando renderizado como HTML, pesaria 16.180 tokens. Em Markdown, isso seria apenas 3.150 tokens. Isso representa uma economia de 80% no uso de tokens. Essa é uma economia real nos custos de inferência. 

De HTML para Markdown

A Cloudflare lida com isso por meio da conversão em tempo real de HTML para Markdown na borda para qualquer site que habilite o Markdown para Agentes. Quando um cliente inclui um Accept: text/markdown header, a Cloudflare busca o HTML original da origem, converte-o para Markdown, e serve o conteúdo transformado em vez da marcação completa da página da web. A empresa afirma que agentes de codificação populares, como Claude Code e OpenCode já enviam esses cabeçalhos, o que significa que muitas ferramentas de IA existentes podem aproveitar imediatamente o recurso.

Para tornar o conteúdo mais amigável para máquinas, a Cloudflare adiciona um cabeçalho de resposta x-markdown-tokens que expõe a contagem de tokens, permitindo que os agentes determinem se um documento se encaixa dentro de sua janela de contexto ou deve ser fragmentado. As respostas convertidas também incluem um cabeçalho content-signal (ai-train=yes, search=yes, ai-input=yes), indicando que o editor permite treinamento de IA, indexação de busca e uso agente por padrão.

A Cloudflare afirma que versões futuras permitirão que os proprietários de sites personalizem essas políticas de sinal de conteúdo além dos padrões atuais.

A resposta da Cloudflare a uma solicitação de Markdown (crédito: Cloudflare).

O Markdown para Agentes depende da negociação de conteúdo HTTP padrão, usando o cabeçalho Accept para distinguir o tráfego humano de crawlers de IA ou outros clientes apenas de texto. Um agente de IA pode solicitar Markdown enviando Accept: text/markdown (geralmente junto com text/html), enquanto visitas regulares de navegadores continuam a receber a página HTML normal. A borda da Cloudflare então realiza a conversão “on the fly,” sem exigir alterações nos modelos de site, configurações de CMS ou endpoints de Markdown separados.

Começando

Os clientes da Cloudflare nos planos Pro e Business podem ativar o recurso na seção de Controle de Rastreamento de IA do painel da Cloudflare, onde o Markdown para Agentes aparece como um botão dedicado. A mesma capacidade está disponível através da API da Cloudflare.

Para provedores de SaaS que usam Cloudflare para SaaS, a conversão para Markdown pode ser ativada para todos os nomes de host personalizados através de um interruptor de “Ações Rápidas” no painel, ou habilitada seletivamente por nome de host usando metadados e configurações personalizadas.

A Cloudflare apresenta o Markdown como uma língua franca de fato para agentes de IA. A Cloudflare não é a única empresa a ter percebido as vantagens de usar Markdown para agentes e ML. 

Markdown Alternativo

Por exemplo, Joost de Valk, um empreendedor da Internet holandês e desenvolvedor do WordPress, tem um plugin para WordPress, Markdown Alternativo, que também funciona com agentes. Ele escreve que sua abordagem e a Cloudflare podem trabalhar juntas. “Um site WordPress poderia usar Markdown Alternativo para markdown rico, ciente do WordPress, com URLs dedicadas e metadados completos, enquanto o recurso da Cloudflare fornece uma base para todos os outros sites em sua rede. O plugin lhe dá controle e profundidade; a Cloudflare lhe dá amplitude e zero esforço.”

Existem também programas mais diretamente competitivos, como

Com a nova funcionalidade da Cloudflare, empresas brasileiras podem otimizar seus sites para interações com agentes de IA, reduzindo custos e melhorando a eficiência. A conversão em Markdown torna o conteúdo mais acessível para modelos de linguagem, beneficiando o SEO e a indexação.