Sirva Markdown para agentes de IA via headers Accept

A proposta

Sites podem entregar uma versão em Markdown do mesmo conteúdo que já oferecem em HTML para navegadores. A negociação ocorre por meio do cabeçalho HTTP Accept: text/markdown: o cliente solicita o formato, e o servidor responde com Markdown quando o suporte existe. A ideia é permitir que agentes de IA leiam diretamente o conteúdo principal, sem precisar processar navegação, scripts, estilos e elementos de layout da página.

Benefícios alegados

A página apresenta três vantagens. A primeira é a redução no volume de dados: como o Markdown elimina componentes de apresentação, uma fração menor dos bytes é transferida e o agente pode concentrar seu contexto no texto principal, em vez de no DOM. A segunda é uma melhor relação entre sinal e ruído na recuperação de informações, pois anúncios, trilhos de conteúdo relacionado e janelas modais deixam de interferir no texto que um pipeline de RAG precisa incorporar.

A terceira é a redução de latência. Com menos conteúdo para buscar e analisar, haveria menos dados para inserir na janela de contexto antes de o modelo começar a processar a solicitação, o que pode acelerar a produção do primeiro token. A fonte apresenta esses efeitos como consequências de servir uma representação mais limpa, não como garantias universais para qualquer agente ou site.

Requisitos técnicos

Para avaliar se uma URL está preparada, a ferramenta verifica se o servidor atende a solicitações com Accept: text/markdown, define Vary: Accept, rejeita tipos não suportados com o status 406 e respeita valores de qualidade (q-values). O uso de Vary: Accept sinaliza que a resposta pode variar conforme o formato solicitado, aspecto relevante para o cache.

A página fornece comandos curl para inspecionar os cabeçalhos e buscar o corpo Markdown, além de um verificador que faz a solicitação a partir da borda e mostra o que o servidor de origem realmente retorna. Também orienta o leitor a começar com uma configuração mínima: um servidor e duas respostas, HTML e Markdown, disponíveis na mesma URL por meio da negociação de conteúdo.

Guias e compatibilidade

O material seguinte é organizado em guias sobre fundamentos e correção, incluindo Vary, valores q, respostas 406, cache e um atalho de configuração sem ajustes adicionais no Cloudflare. As receitas reúnem configurações para Nginx, Caddy, WordPress, Discourse, Laravel, Rails, Cloudflare Workers, Next.js, Astro, Apache, SvelteKit, Nuxt/Nitro, Express, Go e Django.

Há ainda uma matriz de suporte para indicar quais agentes de IA enviam Accept: text/markdown quando suas ferramentas de navegação ou busca acessam uma URL. A seção de referência relaciona a proposta às RFCs 9110 e 7763, ao tipo de mídia text/markdown e a especificações próximas. A tese central é que a negociação de conteúdo permite servir Markdown limpo aos agentes sem deixar de entregar HTML aos navegadores.