--- title: "Negociação de conteúdo: servir Markdown a quem pede Accept: text/markdown | Grupo Marfre" description: "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." canonical: https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/ alternate_html: https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Negociação de conteúdo: servir Markdown a quem pede Accept: text/markdown **Resposta rápida:** Negociação de conteúdo é o mecanismo HTTP em que a mesma URL devolve formatos diferentes conforme o pedido. Na régua do Grupo Marfre, a página entrega Markdown a quem manda Accept: text/markdown, acrescenta ?mode=agent ou se identifica como robô de IA; Googlebot e Bingbot recebem HTML, e toda resposta leva Vary: Accept, Accept-Encoding, User-Agent. Negociação de conteúdo permite que uma única URL entregue HTML para o navegador e Markdown para o agente de IA, sem criar um endereço separado que o visitante precise adivinhar. O servidor lê o pedido, decide o formato e responde. O agente recebe texto limpo, sem menu, script ou rodapé. Na prática, o site agêntico combina essa negociação com o [espelho em Markdown de cada página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/). Abaixo estão o funcionamento, as três formas de pedir o Markdown, o motivo de os buscadores tradicionais receberem HTML e o roteiro de teste com curl. ## Como funciona a negociação de conteúdo pelo cabeçalho Accept? O cliente (navegador, robô ou script) informa no cabeçalho `Accept` quais formatos aceita. O servidor compara a lista com o que tem disponível e devolve uma das versões. Um agente que prefere Markdown e aceita HTML como segunda opção manda, por exemplo: ``` Accept: text/markdown, text/html;q=0.9 ``` O `q=0.9` é o peso: quanto menor, menor a preferência. Um navegador comum manda `text/html` em primeiro lugar e recebe a página normal. Como a mesma URL gera respostas diferentes, o servidor também precisa avisar os caches disso com o cabeçalho `Vary`, tema da página sobre o [cabeçalho Vary](https://grupomarfre.com.br/sites-agenticos/cabecalho-vary/). ## Quais são as três formas de pedir o Markdown? Na régua do Grupo Marfre, o espelho `.md` é servido em três situações. Qualquer uma basta: | Forma | Como o pedido chega | Para quem serve | | --- | --- | --- | | Cabeçalho | `Accept: text/markdown` | Agente que sabe negociar formato | | Parâmetro | `?mode=agent` no fim da URL | Ferramenta que não consegue mudar cabeçalho, ou teste manual | | User-agent | Robô de IA identificado (por exemplo, GPTBot) | Rastreador que não manda `Accept` específico | O parâmetro existe porque nem todo cliente permite editar cabeçalhos. O user-agent cobre os robôs que apenas pedem a URL. Na implementação do método do Grupo Marfre, a lógica fica num middleware na borda (Cloudflare Pages Functions), detalhado em [camada agêntica no Cloudflare Pages](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/). ## Por que Googlebot e Bingbot recebem HTML? Na régua do Grupo Marfre, Googlebot e Bingbot recebem o HTML porque ele é a versão canônica da página, a que deve ser indexada. O espelho `.md` leva `X-Robots-Tag: noindex` e fica fora do sitemap, já que seria conteúdo duplicado. Se o buscador recebesse Markdown na URL principal, a versão errada poderia ocupar o lugar da canônica. Isso não tira o site das respostas de IA do Google. Segundo a documentação do Google sobre recursos de IA (atualizada em 10/12/2025), a Visão Geral por IA e o Modo IA usam o índice do Google, e a empresa não exige arquivo, markup ou schema especial. A página precisa estar indexada e elegível a snippet, e para isso o HTML é o caminho. ## Que cabeçalhos a resposta deve levar? Na régua do Grupo Marfre, toda resposta do site, em HTML ou Markdown, leva `Vary: Accept, Accept-Encoding, User-Agent`, porque a regra decide também por user-agent. O navegador segue o padrão HTTP e separa as versões; na borda da Cloudflare, segundo a documentação dela, sem configurar o Vary nas Cache Rules só o `Accept-Encoding` conta. A resposta leva também um cabeçalho `Link` apontando o `.md`, o llms.txt e o sitemap, o que ajuda o agente a descobrir o que existe (veja o [cabeçalho Link, RFC 8288](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/)). O `.md` acrescenta `X-Robots-Tag: noindex`. ## Como testar com curl? Rode quatro pedidos contra uma página real e compare o cabeçalho e o início do corpo. Os exemplos usam um domínio fictício: ```bash ## 1. Markdown pelo cabeçalho curl -s -D - -H "Accept: text/markdown" https://exemplo.com.br/servicos/ | head -30 ## 2. Markdown como robô de IA curl -s -D - -A "GPTBot" https://exemplo.com.br/servicos/ | head -30 ## 3. HTML como Googlebot curl -s -D - -A "Googlebot" https://exemplo.com.br/servicos/ | head -30 ## 4. Controle negativo: rota inexistente curl -s -D - -H "Accept: text/markdown" https://exemplo.com.br/nao-existe-123 | head -15 ``` O que conferir, seguindo a prova em produção do método do Grupo Marfre: 1. O pedido 1 devolve `Content-Type: text/markdown` e o corpo começa com o frontmatter. 2. O pedido 2 também devolve Markdown. 3. O pedido 3 devolve HTML, a canônica. 4. O pedido 4 devolve status 404, em Markdown, e não a home com status 200. 5. Os cabeçalhos trazem `Vary` (com `Accept` na lista) e `Link`. Repita o teste de `?mode=agent` com a URL terminada em `?mode=agent`. Mais receitas estão em [como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/). ## A Cloudflare já faz isso sozinha? Em parte. O recurso Markdown for Agents da Cloudflare (beta, documentação atualizada em 09/10/2026) converte o HTML em Markdown na borda quando o pedido manda `Accept: text/markdown`. Segundo a documentação, está disponível sem custo nos planos Pro, Business e Enterprise e em SSL for SaaS, liga-se na seção AI Crawl Control da zona e só converte HTML. O Grupo Marfre não testou o recurso, e ele não cobre as outras duas formas de pedido (user-agent de robô de IA e `?mode=agent`). Para comparar as opções, veja [Markdown for Agents da Cloudflare](https://grupomarfre.com.br/sites-agenticos/markdown-for-agents-cloudflare/). ## Perguntas frequentes ### Servir Markdown na mesma URL prejudica o SEO? As fontes consultadas não medem esse efeito. Na régua do Grupo Marfre, Googlebot e Bingbot recebem o HTML, o `.md` leva `noindex` e fica fora do sitemap, porque indexado ele seria conteúdo duplicado. Assim o buscador continua vendo uma única versão canônica. ### Preciso do ?mode=agent se já uso Accept? Não é obrigatório, mas ajuda. Alguns clientes e ferramentas de teste não editam cabeçalhos, e o parâmetro dá a eles um jeito simples de pedir o Markdown. ### Por que o teste com `-A Googlebot` não prova que o Google é o Google? O user-agent é só uma declaração, e qualquer script pode copiá-lo. O teste confirma a regra do seu servidor, não a identidade de quem chama. ### O Markdown é escrito à mão, separado do site? Não. Na régua do Grupo Marfre, o `.md` é gerado da mesma fonte do HTML, para os dois nunca divergirem. ## Fontes consultadas - [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/) - [developers.google.com/search/docs/appearance/ai-features](https://developers.google.com/search/docs/appearance/ai-features) - [developers.cloudflare.com/cache/concepts/vary/](https://developers.cloudflare.com/cache/concepts/vary/) ## Leia também ### [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. ### [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. ### [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. ### [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. ### [Markdown for Agents da Cloudflare: o que é e quando usar](https://grupomarfre.com.br/sites-agenticos/markdown-for-agents-cloudflare/) Markdown for Agents da Cloudflare converte HTML em Markdown para quem pede Accept: text/markdown. Veja planos, limites e quando o espelho gerado é melhor. ### [Como escrever um llms.txt bom (com modelo pronto)](https://grupomarfre.com.br/sites-agenticos/como-escrever-llms-txt/) Como escrever um llms.txt bom: estrutura em 6 blocos, modelo pronto com a Padaria Exemplo, erros comuns e como conferir antes de publicar o arquivo. --- ## 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/negociacao-de-conteudo-markdown/