Pular para o conteúdo
Navegar na documentação
Nesta página

Front matter e resolução de metadata

Front matter é reconhecido somente em MDX quando a primeira linha é exatamente --- e existe outro delimitador --- de fechamento.

---
title: Exemplo
date: 2026-08-18T12:00:00+00:00
extra:
  category: guia
---
# Corpo

O conteúdo entre delimitadores precisa resultar em um mapa YAML. Sem delimitador inicial, todo o arquivo é corpo e a metadata fica vazia; delimitador sem fechamento é erro.

Cascata de MDX

Para um documento, a engine procura _defaults.yaml desde a raiz de Content/Pages/ até sua pasta:

Content/Pages/_defaults.yaml
Content/Pages/blog/_defaults.yaml
Content/Pages/blog/guias/post.mdx

A ordem, da menor para a maior precedência, é:

  1. _defaults.yaml mais próximo da raiz;
  2. cada _defaults.yaml descendente;
  3. front matter do documento;
  4. defaults e enriquecimento da Collection, respeitando a precedência própria dos itens.

Cada combinação é rasa no primeiro nível. Se um nível declarar social, sitemap ou extra, substitui o bloco anterior inteiro.

Chaves desconhecidas são detectadas antes da validação de tipos. Em cascatas MDX, o erro identifica o arquivo que introduziu o bloco raiz; nomes próximos podem receber sugestão.

Blade

Páginas Blade leem apenas o sidecar YAML obrigatório. _defaults.yaml não participa. A metadata do sidecar é validada e hidratada diretamente, antes dos defaults de Collection quando a página for um item.

O schema aceito está em Metadata. A precedência adicional de Collections está na Referência de Collections.

Datas sem histórico Git

As datas de publicação dos itens de Collection e o lastModified das páginas usam o histórico Git quando disponível. Configure content.dates.policy para definir a alternativa quando o arquivo não estiver commitado (por exemplo, na imagem builder): mtime (default, com aviso), fail (interrompe o build) ou explicit (exige date no front matter). O campo date aceita uma data ISO-8601 e também pode ser definido em _defaults.yaml.