--- title: "Cabeçalho Link (RFC 8288): como o agente descobre a versão em Markdown | Grupo Marfre" description: "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." canonical: https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/ alternate_html: https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Cabeçalho Link (RFC 8288): como o agente descobre a versão em Markdown **Resposta rápida:** O cabeçalho HTTP Link é uma linha na resposta do servidor que aponta a versão em Markdown (rel=“alternate”), o llms.txt (rel=“describedby”) e o sitemap. O agente pode ler essa linha até com uma requisição HEAD, sem baixar o HTML. Em site gerado, o ideal é montá-lo na borda, página por página. O cabeçalho `Link` é uma linha da resposta HTTP que diz ao agente onde estão os outros formatos e arquivos ligados àquela página. Num site agêntico, ele aponta três coisas: o espelho em Markdown (`.md`), o `llms.txt` que descreve o site e o sitemap. Um agente que lê o cabeçalho fica sabendo disso antes de ler uma única linha do HTML. A RFC 8288 define essa sintaxe de links na web. Esta página mostra o formato, um exemplo pronto, a diferença para a tag `` no `` e o motivo de montar o cabeçalho na borda quando o site é gerado. ## O que o cabeçalho Link informa ao agente? Ele informa a relação entre a página pedida e outro recurso. Cada relação tem um nome (`rel`) e, quando útil, o tipo do arquivo (`type`). Para o Markdown, três relações bastam: | Relação | Aponta para | Para que serve | | --- | --- | --- | | `rel="alternate"` com `type="text/markdown"` | o espelho `.md` da mesma página | o agente lê o conteúdo limpo, sem menu e sem script | | `rel="describedby"` | o `llms.txt` | o agente chega ao resumo e ao índice do site | | `rel="sitemap"` | o `sitemap.xml` | o agente descobre as demais páginas | A proposta do llmstxt.org (v2, página modificada em 10/08/2026) prevê o espelho em `pagina.md` ou `pagina.html.md`, descoberto por `rel="alternate" type="text/markdown"`. Prevê também o `llms.txt` ligado à página por `rel="describedby"`, em `` ou no cabeçalho `Link`. Detalhes do arquivo estão em [llms.txt v2: espelho .md e rel="describedby"](https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/). ## Como é o formato do cabeçalho? Cada link vai entre `<` e `>`, seguido de parâmetros separados por ponto e vírgula. Vários links vão na mesma linha, separados por vírgula. Exemplo com uma empresa fictícia (exemplo.com.br): ``` HTTP/2 200 content-type: text/html; charset=utf-8 vary: Accept, Accept-Encoding, User-Agent link: ; rel="alternate"; type="text/markdown", ; rel="describedby"; type="text/markdown", ; rel="sitemap" ``` Pontos de atenção na escrita: 1. A URL fica entre `<>`, e o valor de `rel` entre aspas. 2. Use URL absoluta, como no exemplo. 3. A vírgula separa links; o ponto e vírgula separa parâmetros do mesmo link. 4. O endereço apontado precisa responder 200. Um `Link` para `.md` que dá 404 é pior que nenhum `Link`. ## Qual a diferença para a tag link no head? A tag `` diz a mesma coisa, mas está dentro do HTML. Para ler, o agente precisa baixar e interpretar o documento. O cabeçalho vem na resposta HTTP e pode ser lido numa requisição `HEAD`, que devolve só os cabeçalhos. | Critério | Cabeçalho `Link` | Tag `` no `` | | --- | --- | --- | | Onde fica | resposta HTTP | dentro do HTML | | Exige baixar o HTML | não | sim | | Funciona com `curl -I` | sim | não | | Pode descrever arquivos que não são HTML | sim | só dentro de páginas HTML | Um não substitui o outro. O método do Grupo Marfre entrega os dois: cabeçalho `Link` e `` no HTML. O detalhe da tag está em [A tag link rel="alternate" type="text/markdown"](https://grupomarfre.com.br/sites-agenticos/link-rel-alternate-markdown/). ## Por que montar o cabeçalho na borda em site gerado? Porque o endereço do `.md` muda a cada página, e o HTML gerado não carrega cabeçalhos HTTP. Uma regra fixa de cabeçalho repetiria o mesmo valor em todas as rotas. Um middleware na borda calcula o alvo a partir do caminho pedido e anexa o cabeçalho em toda resposta, sem mexer em página por página. No método do Grupo Marfre, o middleware roda em Cloudflare Pages Functions e junta numa só camada: - negociação por `Accept: text/markdown`, por `?mode=agent` e por user-agent de robô de IA; - Googlebot e Bingbot recebem o HTML (a canônica); - `Vary: Accept, Accept-Encoding, User-Agent` (a regra decide também por user-agent) e cabeçalho `Link` em toda resposta, apontando o `.md`, o `llms.txt` e o sitemap; - `X-Robots-Tag: noindex` no `.md`, que também fica fora do sitemap, para não virar conteúdo duplicado; - 404 em Markdown para rota inexistente. O `Vary` é o par obrigatório da negociação, não do `Link`: quando a mesma URL serve HTML ou Markdown, sem ele um cache pode entregar a resposta em Markdown a quem pediu HTML. Veja [Cabeçalho Vary](https://grupomarfre.com.br/sites-agenticos/cabecalho-vary/). A implementação completa está em [Camada agêntica no Cloudflare Pages](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/), e a lógica de escolha do formato em [Negociação de conteúdo](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/). ## Como testar se o cabeçalho está certo? Peça só os cabeçalhos e filtre a linha `link`. Troque o endereço pelo da sua página: ``` curl -sI https://www.exemplo.com.br/servicos/consultoria/ | grep -i '^link' ``` Depois confira cada destino com um GET (o `-I` envia HEAD, e alguns servidores respondem a ele de outro jeito): ``` curl -s -D - -o /dev/null https://www.exemplo.com.br/servicos/consultoria.md | grep -i -E '^(HTTP|content-type)' curl -s -D - -o /dev/null https://www.exemplo.com.br/llms.txt | grep -i -E '^(HTTP|content-type)' curl -s -D - -o /dev/null https://www.exemplo.com.br/sitemap.xml | grep -i -E '^(HTTP|content-type)' ``` O teste passa quando as três respostas voltam com 200 e o `.md` declara `text/markdown`. Para ver a negociação, peça a página com `-A GPTBot` e com `-A Googlebot` e compare o `content-type`: na régua do Grupo Marfre, o primeiro recebe `text/markdown` e o segundo, `text/html`. As receitas completas 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 cabeçalho Link faz a IA citar meu site? Não. Ele só facilita a descoberta do conteúdo em Markdown. Quem decide citar é o modelo, e nenhum cabeçalho garante isso. ### Preciso do cabeçalho e da tag link no head? O ideal é ter os dois. O cabeçalho serve a quem consulta só a resposta HTTP, e a tag serve a quem já baixou o HTML. ### O Google usa o cabeçalho Link para achar o .md? As fontes consultadas não dizem. Na régua do Grupo Marfre, Googlebot e Bingbot recebem o HTML, não o espelho. Em 15/06/2026 o Google declarou que a Busca não precisa do `llms.txt` e que ele não afeta o ranking. O cabeçalho serve a outros sistemas que queiram ler o Markdown. ### Dá para configurar sem Cloudflare? Dá. Qualquer servidor ou CDN que permita definir cabeçalhos de resposta por rota ou por código serve. O requisito é calcular o endereço do `.md` para cada página e, se a mesma URL também negocia o formato, anexar o `Vary` junto. ## Fontes consultadas - [llmstxt.org/](https://llmstxt.org/) ## Leia também ### [A tag link rel="alternate" type="text/markdown"](https://grupomarfre.com.br/sites-agenticos/link-rel-alternate-markdown/) Como escrever a tag link rel=“alternate” type=“text/markdown” no head, injetá-la na borda e contar com curl quais páginas do site anunciam o espelho .md. ### [llms.txt v2: espelho .md e rel="describedby"](https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/) llms.txt v2: espelho pagina.md, descoberta por rel=alternate e ligação por rel=describedby. Veja exemplos de cabeçalho e como migrar de rel=llms-txt. ### [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. ### [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. ### [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. ### [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/cabecalho-link-rfc-8288/