YAML no Quarto: O Coração Invisível dos Seus Documentos

programação
Autor

Blog do Marcellini

Data de Publicação

29 de junho de 2025

Introdução

O YAML é a primeira coisa que aparece em um documento .qmd — mas para muitos, é também a mais misteriosa.

Neste post, vamos entender: - O que é YAML - Como ele funciona nos arquivos .qmd - Principais campos usados em projetos com Quarto - Exemplos práticos de cabeçalhos YAML


O que é YAML?

YAML significa “YAML Ain’t Markup Language”, ou seja, “YAML não é uma linguagem de marcação” — embora se pareça com uma.

Ele é um formato legível por humanos, usado para declarar configurações.
É simples, indentado com espaços (não tabulações), e usa pares chave:valor.


Exemplo mínimo

---
title: "Meu Documento"
author: "Celso Marcellini"
format: html
---

Onde o YAML é usado no Quarto?

No topo de qualquer arquivo .qmd, entre --- e ---.

O YAML define como o documento será processado e renderizado: título, autor, formato de saída, opções de execução de código, capa, sumário e muito mais.


Campos comuns no YAML do Quarto

Campo Descrição
title Título do documento
author Nome do(s) autor(es)
date Data de criação ou publicação
format Formato de saída: html, pdf, epub, docx
editor Tipo de editor usado (ex: visual)
lang Idioma do documento (ex: pt-BR)
cover-image Capa usada para EPUB ou PDF
toc Mostra o sumário (true ou false)
execute Regras de execução do código

Exemplo completo

---
title: "Análise de Dados com R"
author: "Celso Marcellini"
date: 2025-06-23
format: html
lang: pt-BR
toc: true
execute:
  engine: knitr
  echo: true
  warning: false
  message: false
---

Cuidados ao usar YAML

  • Use espaços, nunca TAB.
  • ✅ A identação deve ser consistente.
  • ✅ Listas são feitas com - item.
  • ✅ Blocos de texto longos podem usar | (para manter quebras) ou > (para unir linhas).

Conclusão

O YAML pode parecer apenas um bloco técnico no início do .qmd, mas ele é a alma da configuração no Quarto.
Dominar o YAML é essencial para personalizar seus documentos, projetos, sites e livros.


Criado por Blog do Marcellini com ❤️ e código.