--- title: "llms.txt v2: espelho .md e rel=\"describedby\" | Grupo Marfre" description: "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." canonical: https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/ alternate_html: https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/ language: pt-BR last_updated: 2026-10-27 type: guia --- # llms.txt v2: espelho .md e rel="describedby" **Resposta rápida:** A v2 do llms.txt (página da proposta modificada em 10/08/2026) acrescenta um espelho em Markdown de cada página (pagina.md ou pagina.html.md), descoberto por rel=“alternate” type=“text/markdown”, e liga a página ao llms.txt por rel=“describedby”, em ou no cabeçalho Link. O rel=“llms-txt” não faz parte da proposta. A v2 da proposta do llms.txt deixa de tratar o arquivo como um índice solto na raiz e passa a ligá-lo a cada página. Segundo o site da proposta (llmstxt.org, página modificada em 10/08/2026), cada página ganha um espelho em Markdown e uma forma padronizada de apontar para ele e para o llms.txt. Na prática, são três peças: o arquivo espelho, a indicação dele no HTML e a ligação da página com o llms.txt. Quem já tem um llms.txt básico (veja [o que é llms.txt](https://grupomarfre.com.br/sites-agenticos/llms-txt/)) precisa acrescentar as três e, se usava `rel="llms-txt"`, trocar o valor. ## O que mudou na v2 do llms.txt? A v1 pedia um arquivo Markdown na raiz: H1 com o nome do site, citação em bloco com o resumo e seções com listas de links. A v2 mantém isso e acrescenta três itens, conforme llmstxt.org: | Item | O que é | | --- | --- | | Espelho | Versão em Markdown da página, em `pagina.md` ou `pagina.html.md` | | Descoberta do espelho | `rel="alternate" type="text/markdown"` no HTML | | Ligação ao llms.txt | `rel="describedby"` em `` ou no cabeçalho `Link` | O Google declarou em 15/06/2026 (changelog) que a Busca não precisa do llms.txt e que ele não afeta o ranking, nem para mais nem para menos. Manter o arquivo serve a outros sistemas que o leiam. A evidência de efeito em citação por IA ainda é anedótica, segundo o que o mercado publicou. ## Como funciona o espelho pagina.md ou pagina.html.md? O espelho é a mesma página em Markdown, num endereço terminado em `.md`. Na forma `pagina.md`, a página `/servicos/consultoria/` tem o espelho em `/servicos/consultoria.md`; a proposta também aceita a forma `pagina.html.md`. Escolha um dos dois padrões e use em todo o site. Na régua do Grupo Marfre, o espelho sai da mesma fonte do HTML, gerado e nunca redigido à parte, para os dois não divergirem. O `.md` leva `X-Robots-Tag: noindex` e fica fora do sitemap, porque seria conteúdo duplicado da página canônica. Detalhes de geração em [espelho em Markdown de cada página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/). ## Como o agente descobre o espelho? A página HTML declara o espelho com uma tag `` no ``. Esse é o `rel="alternate"` com tipo `text/markdown`: ```html ``` O mesmo aviso pode ir no cabeçalho de resposta, útil quando o agente só lê os cabeçalhos: ```http Link: ; rel="alternate"; type="text/markdown" ``` O formato do cabeçalho segue a RFC 8288, explicada em [cabeçalho Link (RFC 8288)](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/). A tag em si tem página própria: [link rel="alternate" type="text/markdown"](https://grupomarfre.com.br/sites-agenticos/link-rel-alternate-markdown/). ## Como ligar a página ao llms.txt com rel="describedby"? O `rel="describedby"` diz que o llms.txt descreve aquela página. Ele entra de duas formas, e o site pode usar as duas. No HTML: ```html ``` No cabeçalho de resposta: ```http Link: ; rel="describedby" ``` Um cabeçalho `Link` pode carregar vários valores separados por vírgula. Exemplo fictício de uma resposta completa para `exemplo.com.br`: ```http HTTP/2 200 content-type: text/html; charset=utf-8 vary: Accept, Accept-Encoding, User-Agent link: ; rel="alternate"; type="text/markdown", ; rel="describedby", ; rel="sitemap" ``` Nos sites do Grupo Marfre, toda resposta leva `Vary: Accept, Accept-Encoding, User-Agent` (a regra decide também por user-agent) e um `Link` apontando o `.md`, o llms.txt e o sitemap. O que o `Vary` faz no navegador e na borda da Cloudflare está em [cabeçalho Vary](https://grupomarfre.com.br/sites-agenticos/cabecalho-vary/). ## Como migrar de rel="llms-txt" para rel="describedby"? O `rel="llms-txt"` não faz parte da proposta. Se o site usa esse valor, ele não tem base na especificação, e não há como contar com algum agente lendo. A migração tem quatro passos: 1. Procure o valor no código do tema, nos templates e na configuração do servidor: `grep -rn 'llms-txt' .` lista as linhas com o valor; confira cada uma, porque o mesmo texto pode aparecer fora do atributo `rel`. 2. Troque `rel="llms-txt"` por `rel="describedby"`, mantendo o `href="/llms.txt"`. Faça o mesmo no cabeçalho `Link`. 3. Acrescente o `` apontando para o espelho de cada página que tenha um. 4. Confirme com curl que o cabeçalho e a tag saem em todas as páginas, não só na home. Antes: ``. Depois: ``. ## Como conferir que a v2 está no ar? Três comandos com curl bastam (troque o domínio e o caminho). O primeiro confere o cabeçalho, o segundo a tag no HTML e o terceiro o espelho: ```bash curl -s -D - -o /dev/null https://exemplo.com.br/servicos/consultoria/ | grep -i '^link' curl -s https://exemplo.com.br/servicos/consultoria/ | grep -i 'rel="describedby"\|text/markdown' curl -s https://exemplo.com.br/servicos/consultoria.md | head -n 12 ``` O terceiro deve devolver Markdown (na régua do Grupo Marfre, com frontmatter), não HTML. Se vier o HTML da home, o site está entregando uma página de erro disfarçada (soft 404). Mais receitas em [como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/). Ter a v2 no ar mostra que o site está pronto para quem a lê. Não garante citação nem recomendação por nenhuma IA. ## Perguntas frequentes ### O Google exige o llms.txt v2? Não. O Google declarou em 15/06/2026 que a Busca não precisa do llms.txt e que ele não afeta o ranking. A v2 serve a sistemas que leiam o arquivo. ### Uso pagina.md ou pagina.html.md? Qualquer um dos dois, desde que o site siga o mesmo padrão em todas as páginas. Misturar os dois dificulta a conferência e a manutenção. ### O espelho .md deve entrar no sitemap? Na régua do Grupo Marfre, não. O sitemap lista só o HTML, e o `.md` sai com `X-Robots-Tag: noindex` para não competir com a página canônica. ### Preciso do cabeçalho Link se já tenho a tag no HTML? Não é obrigatório usar os dois. A tag no `` basta para quem lê o HTML. O cabeçalho ajuda quem só consulta a resposta, e dá para ligar o llms.txt mesmo em arquivos que não são HTML. ## Fontes consultadas - [llmstxt.org/](https://llmstxt.org/) ## Leia também ### [O que é llms.txt e para que serve](https://grupomarfre.com.br/sites-agenticos/llms-txt/) llms.txt é um arquivo Markdown na raiz do site que resume o negócio para IA. Veja o formato, quem lê, a diferença para robots.txt e sitemap e se vale criar. ### [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. ### [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. ### [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. ### [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 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. --- ## 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/llms-txt-v2/