--- title: "Espelho em Markdown de cada página: o que é e como gerar | Grupo Marfre" description: "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." canonical: https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/ alternate_html: https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Espelho em Markdown de cada página: o que é e como gerar **Resposta rápida:** O espelho em Markdown é uma cópia de cada página em texto limpo, publicada ao lado dela com a extensão .md (por exemplo, /sobre.md). Na régua do Grupo Marfre, ele é gerado da mesma fonte do HTML, leva frontmatter YAML e fica com noindex e fora do sitemap. O espelho em Markdown é a mesma página que o visitante vê, escrita em texto simples e publicada no endereço dela com `.md` no fim. Um agente de IA que chega nesse arquivo lê o conteúdo sem menu, script ou banner. O formato em si está explicado em [Markdown: o formato de texto limpo para agentes de IA](https://grupomarfre.com.br/sites-agenticos/markdown/). A regra de ouro, na régua do Grupo Marfre: o espelho nunca é escrito à mão. Ele sai da mesma fonte que gera o HTML, a cada publicação. É assim que o Grupo Marfre monta o espelho nos sites que publica. ## Onde fica o arquivo do espelho? O arquivo fica ao lado da página, com o mesmo caminho e a extensão `.md`. A proposta do llmstxt.org, na versão 2 (página modificada em 10/08/2026), aceita duas formas: `pagina.md` ou `pagina.html.md`. Escolha uma e use em todas as páginas. Exemplo fictício, para o site `www.exemplo.com.br`: | Página (HTML) | Espelho (Markdown) | | --- | --- | | /sobre/ | /sobre.md | | /servicos/limpeza-de-pele/ | /servicos/limpeza-de-pele.md | | /contato/ | /contato.md | O agente pode descobrir o arquivo por um `` no HTML ou pelo cabeçalho `Link`. Os dois caminhos estão em [A tag link rel="alternate" type="text/markdown"](https://grupomarfre.com.br/sites-agenticos/link-rel-alternate-markdown/) e em [llms.txt v2: espelho .md e rel="describedby"](https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/). ## Por que gerar da mesma fonte e não redigir à parte? Porque dois textos mantidos separadamente podem divergir. Alguém muda o preço, o telefone ou o horário no HTML, esquece o `.md`, e o agente que lê o espelho recebe o dado velho como se fosse atual. Na régua do Grupo Marfre, o espelho sai da mesma fonte do HTML: gerado, nunca redigido à parte. Teste que você roda em dois minutos: escolha um dado que muda (telefone, endereço, horário) e compare as duas versões. ```bash curl -s https://www.exemplo.com.br/contato/ | grep -oE "[0-9]{4,5}-[0-9]{4}" curl -s https://www.exemplo.com.br/contato.md | grep -oE "[0-9]{4,5}-[0-9]{4}" ``` Se os dois números diferirem, o espelho está sendo mantido à parte. Corrija o processo de geração, não só o arquivo. Dado desencontrado entre versões é uma das portas para o que [Alucinação de IA](https://grupomarfre.com.br/sites-agenticos/alucinacao-de-ia/) descreve. ## O que entra no frontmatter YAML? O frontmatter é o bloco entre `---` no topo do arquivo, com os metadados da página. No método do Grupo Marfre, ele leva sete campos: `title`, `description`, `canonical`, `alternate_html`, `language`, `last_updated` e `type`. Os valores vêm da própria fonte da página, sem digitação extra. Exemplo com empresa fictícia: ```markdown --- title: "Limpeza de pele em Belo Horizonte" description: "Como funciona a limpeza de pele na Clínica Exemplo, para quem é indicada e como agendar." canonical: "https://www.exemplo.com.br/servicos/limpeza-de-pele/" alternate_html: "https://www.exemplo.com.br/servicos/limpeza-de-pele/" language: "pt-BR" last_updated: "2026-10-20" type: "service" --- ## Limpeza de pele em Belo Horizonte Texto da página começa aqui. ``` O `canonical` aponta para o HTML, a versão que vale. O `last_updated` deve refletir mudança real de conteúdo. Cada campo é detalhado em [Frontmatter YAML no espelho Markdown](https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/). ## O que tirar da página ao gerar o Markdown? Tire tudo o que serve à navegação e não ao conteúdo: menu, rodapé, botões, banner de cookies, formulários, widgets de chat e scripts. Fica o que responde à pergunta de quem lê: título, texto, listas, tabelas e os links que estão dentro do texto. Uma checagem prática, depois de gerar: 1. Abra o `.md` e procure por "Aceitar cookies", "Menu" e "Todos os direitos reservados". Nenhum deve aparecer. 2. Confira se o H1 é a primeira linha depois do frontmatter. 3. Confira se as tabelas e listas continuaram tabelas e listas, e não texto corrido. 4. Veja se botões de ação importantes (como "Agendar") viraram uma frase com link, para o agente saber como o visitante chega ao próximo passo. ## Como evitar que o espelho vire conteúdo duplicado? Marque o `.md` com `X-Robots-Tag: noindex` e deixe o arquivo fora do sitemap. Na régua do Grupo Marfre, é assim que se evita duplicar o conteúdo: o sitemap lista só as páginas HTML, e o espelho existe para agentes, não para o índice de busca. No método do Grupo Marfre, o servidor entrega o `.md` a quem manda `Accept: text/markdown`, a quem acrescenta `?mode=agent` ou ao user-agent de robô de IA. Googlebot e Bingbot recebem o HTML, que é a canônica. Para conferir: ```bash curl -s -D - -o /dev/null https://www.exemplo.com.br/sobre.md | grep -i "x-robots-tag" ``` A resposta esperada é `X-Robots-Tag: noindex`. O mecanismo completo está em [Negociação de conteúdo: servir Markdown a quem pede Accept: text/markdown](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/). Para a lista do sitemap, veja [Sitemap com lastmod real](https://grupomarfre.com.br/sites-agenticos/sitemap-com-lastmod/). ## Que arquivos de ferramenta precisam ser barrados? Qualquer arquivo de trabalho que suba junto no deploy, como README e arquivos de configuração. Na experiência do Grupo Marfre, sem essa barreira um `/README` com cabeçalho de Markdown virava `/README.md` e saía inteiro para o robô. Teste de controle depois de cada publicação: ```bash curl -s -o /dev/null -w "%{http_code}\n" https://www.exemplo.com.br/README.md curl -s -o /dev/null -w "%{http_code}\n" -A GPTBot https://www.exemplo.com.br/README ``` O esperado é `404` nas duas linhas. Se vier `200`, abra a resposta: ou o deploy está expondo arquivo que não é página do site, ou o site devolve a home para qualquer endereço inexistente (soft 404), que é outro defeito. ## Perguntas frequentes ### O espelho em Markdown substitui a página HTML? Não. O HTML continua sendo a página para o visitante e a versão canônica para o Google e o Bing. O `.md` é uma cópia enxuta, feita para agentes de IA. ### Preciso do espelho se já tenho o llms.txt? São arquivos diferentes. O llms.txt resume o site inteiro e indica os caminhos, enquanto o espelho entrega o conteúdo completo de cada página. Na versão 2 da proposta, os dois se ligam. ### Posso editar o arquivo .md manualmente para ajustar um detalhe? Evite. A edição some na próxima geração ou, pior, faz o espelho divergir do HTML. Ajuste na fonte da página, e os dois arquivos saem corretos. ### Meu construtor de site gera o espelho sozinho? Depende do construtor. Se o seu não permite criar arquivos na raiz, veja [Meu construtor de site não deixa mexer na raiz: e agora?](https://grupomarfre.com.br/sites-agenticos/construtor-sem-acesso-a-raiz/). ## Fontes consultadas - [llmstxt.org/](https://llmstxt.org/) ## Leia também ### [Frontmatter YAML no espelho Markdown: os campos que importam](https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/) Frontmatter YAML no espelho Markdown: os 7 campos (title, description, canonical, alternate\_html, language, last\_updated, type), exemplo e erros de formato. ### [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. ### [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. ### [Markdown: o formato de texto limpo para agentes de IA](https://grupomarfre.com.br/sites-agenticos/markdown/) Markdown é um formato de texto simples com marcações leves. Veja por que ele entrega ao agente só o conteúdo, sem o código da página, e onde ele aparece. ### [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. --- ## 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/espelho-markdown-por-pagina/