--- title: "Frontmatter YAML no espelho Markdown: os campos que importam | Grupo Marfre" description: "Frontmatter YAML no espelho Markdown: os 7 campos (title, description, canonical, alternate_html, language, last_updated, type), exemplo e erros de formato." canonical: https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/ alternate_html: https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Frontmatter YAML no espelho Markdown: os campos que importam **Resposta rápida:** O frontmatter do espelho Markdown é o bloco YAML no topo do arquivo .md. No método do Grupo Marfre, ele leva sete campos: title, description, canonical, alternate\_html, language, last\_updated e type. O campo que mais exige cuidado é last\_updated, que deve trazer a data real da última mudança de conteúdo, nunca a do build. O frontmatter é um bloco entre duas linhas `---` no começo do arquivo .md. Ele diz ao agente, antes do texto, que página é aquela, onde está a versão canônica, em que idioma foi escrita e quando o conteúdo mudou de verdade. Na régua do Grupo Marfre, o espelho `.md` sai da mesma fonte do HTML (gerado, nunca redigido à parte) e leva sete campos. Esta página cobre o que cada campo guarda, um exemplo completo e os erros que quebram o bloco. Para entender o arquivo em si, veja [o espelho em Markdown de cada página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/). ## Quais campos o frontmatter do espelho precisa ter? Na régua do Grupo Marfre, são sete: `title`, `description`, `canonical`, `alternate_html`, `language`, `last_updated` e `type`. Todos saem da mesma fonte que gera o HTML da página, então o valor no .md e o valor no HTML não têm como divergir. | Campo | O que guarda | Cuidado | | --- | --- | --- | | `title` | O mesmo título da tag `` da página | Entre aspas | | `description` | A mesma meta description | Entre aspas | | `canonical` | Endereço absoluto da versão que vale | Sem parâmetros como `?mode=agent` | | `alternate_html` | Endereço absoluto da versão em HTML desta página | Igual ao `canonical` quando o HTML desta página é a versão que vale | | `language` | Idioma do conteúdo, como `pt-BR` | Igual ao `lang` do HTML | | `last_updated` | Data da última mudança real de conteúdo | Formato `AAAA-MM-DD` | | `type` | Tipo da página, como `article` ou `service` | Conjunto curto e fixo para o site todo | O `canonical` importa porque o espelho não é a página que deve ser indexada. No método do Grupo Marfre, o .md leva `X-Robots-Tag: noindex` e não entra no sitemap, para não virar conteúdo duplicado. O campo devolve o agente ao endereço que vale. Sobre o conceito, veja [URL canônica](https://grupomarfre.com.br/sites-agenticos/canonical/). ## Como fica um frontmatter completo? Fica como o bloco abaixo, que usa uma empresa fictícia. O texto da página começa logo depois do segundo `---`, já em [Markdown](https://grupomarfre.com.br/sites-agenticos/markdown/). ```yaml --- title: "Contabilidade para clínicas: o que o escritório faz" description: "Serviços de contabilidade da Exemplo Contábil para clínicas de saúde: abertura, folha e impostos." canonical: https://www.exemplocontabil.com.br/servicos/contabilidade-para-clinicas/ alternate_html: https://www.exemplocontabil.com.br/servicos/contabilidade-para-clinicas/ language: pt-BR last_updated: 2026-09-14 type: service --- ## Contabilidade para clínicas ``` Três pontos de leitura. O título tem dois-pontos, por isso está entre aspas. A data está no formato ISO, sem hora. E os endereços são absolutos, porque o arquivo pode ser lido fora do contexto do site. ## Por que last\_updated tem de ser a data real do conteúdo? Porque a data é uma afirmação sobre o texto: "isto mudou neste dia". Se ela muda sem que o conteúdo mude, a afirmação é falsa. Segundo o mercado, data de "atualizado em" trocada sem mudar o conteúdo virou gatilho de punição no core update de dezembro de 2025. O Grupo Marfre trata isso como regra. A tentação existe por um motivo concreto. Num estudo da Ahrefs com 17 milhões de citações, os assistentes de IA citaram conteúdo 25,7% mais novo que o do resultado orgânico. Isso não autoriza maquiar a data. Quem quer ser lido como atual precisa de página realmente revisada. Uma regra simples: `last_updated` muda quando muda algo que o leitor usa, como um fato, um endereço, um horário, uma condição de serviço. Corrigir uma vírgula não conta. O mesmo critério vale para o `lastmod` do sitemap, e os dois devem mostrar a mesma data. Detalhes em [sitemap com lastmod real](https://grupomarfre.com.br/sites-agenticos/sitemap-com-lastmod/) e em [atualizar a data da página ajuda a IA a citar?](https://grupomarfre.com.br/sites-agenticos/frescor-e-data-de-atualizacao/). ## Quais erros quebram o frontmatter? Dois pedem atenção especial: aspas mal fechadas e data do dia do build. Os outros vêm de campos copiados à mão: título diferente do HTML, `canonical` com parâmetro, idioma divergente do `lang` da página. **1\. Aspas e dois-pontos.** Em YAML, um título com `:` no meio sem aspas dá erro de leitura, porque o dois-pontos seguido de espaço marca uma chave. Aspas duplas dentro de um valor entre aspas duplas encerram o texto antes da hora. ```yaml ## Errado: o segundo dois-pontos quebra a leitura title: Guia: o que é Markdown ## Errado: aspas internas fecham o valor antes do fim title: "O guia "completo" de Markdown" ## Certo title: "Guia: o que é Markdown" title: 'O guia "completo" de Markdown' ``` O mesmo vale para `description`, que pode ter vírgulas, dois-pontos e citações. Na dúvida, o gerador deve sempre pôr aspas e escapar o que for preciso. **2\. Data do dia do build.** Se o gerador escreve `last_updated` com a data em que o site foi construído, todas as páginas passam a mostrar a data do último deploy, mesmo as que ninguém tocou. É a data cosmética em escala. O valor precisa vir da fonte de cada página (o campo de data editorial do conteúdo, mantido por quem edita), não do relógio do servidor de build. **3\. Espelho redigido à parte.** Se alguém edita o .md na mão, ele se afasta do HTML. A régua do Grupo Marfre é gerar o arquivo da mesma fonte, nunca escrevê-lo separado. **4\. Canonical apontando para o próprio .md.** O campo deve devolver o agente ao HTML canônico. Apontar para o espelho cria um laço com um arquivo que está marcado como noindex. ## Como conferir se o frontmatter está certo? Peça o espelho com `Accept: text/markdown` e leia as primeiras linhas. Depois compare `last_updated` com a data real da última edição de conteúdo daquela página. O teste leva menos de um minuto por endereço. ```bash curl -s -H "Accept: text/markdown" \ https://www.exemplocontabil.com.br/servicos/contabilidade-para-clinicas/ \ | head -12 ``` Verifique, nesta ordem: 1. O bloco abre e fecha com `---`, sem linha em branco antes do primeiro. 2. `title` e `description` batem com os do HTML. 3. `canonical` é o endereço do HTML, sem parâmetros. 4. `last_updated` é a data da última edição real, não a de hoje. 5. Páginas que você não edita há meses não podem mostrar a data de um deploy recente. Se mostram, o gerador está usando o dia do build. O quinto item pega a data do build com uma única comparação. Mais receitas em [como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/), e a regra de quem recebe o .md em [negociação de conteúdo](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/). ## Perguntas frequentes ### O frontmatter aparece para quem visita o site? Não. Ele existe só no arquivo .md, que é servido a agentes. O visitante comum recebe o HTML, onde título, descrição e idioma já estão nas tags da página. ### O llms.txt também usa esse frontmatter? Não. Os sete campos descritos aqui são do espelho de cada página. O llms.txt segue o formato proposto em llmstxt.org: H1 com o nome, citação em bloco com o resumo e seções com listas de links. Veja [o que é llms.txt](https://grupomarfre.com.br/sites-agenticos/llms-txt/). ### Ter frontmatter completo faz a IA citar a página? Não há garantia disso. O frontmatter reduz ambiguidade (qual é a página, qual versão vale, quão recente é), mas a escolha do que citar continua sendo do modelo. ### Posso deixar last\_updated em branco se não souber a data? É melhor omitir o campo do que preencher com um valor falso. Uma data inventada é pior que nenhuma. O ideal é que a fonte do conteúdo sempre carregue a data da última edição real. ## 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. ### [Atualizar a data da página ajuda a IA a citar?](https://grupomarfre.com.br/sites-agenticos/frescor-e-data-de-atualizacao/) Atualizar a data da página ajuda a IA a citar? A data só deve mudar quando o conteúdo muda. Veja o que dizem os dados sobre frescor e como atualizar certo. ### [Sitemap com lastmod real: por que importa e o erro da data cosmética](https://grupomarfre.com.br/sites-agenticos/sitemap-com-lastmod/) Sitemap com lastmod real: liste só HTML canônico, atualize a data quando o conteúdo mudar, deixe o .md de fora e envie ao Search Console e ao Bing. ### [URL canônica: qual versão da página vale](https://grupomarfre.com.br/sites-agenticos/canonical/) URL canônica é a versão da página que vale quando há cópias. Veja a tag canonical, o espelho .md, o sitemap e as variações com barra, www e http. ### [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 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/frontmatter-do-markdown/