📘 👨💻 📄 YAML no Quarto: O Coração Invisível dos Seus Documentos
.qmd — mas para muitos, é também a mais misteriosa.
← Voltar para o Guia de Leitura de Programação 👨💻
← Voltar para a Seção de Quarto 📄
← Voltar para a Seção de Programação 👨💻
1 📘 👨💻 📄 YAML no Quarto: O Coração Invisível dos Seus Documentos
1.1 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
1.2 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.
1.3 Exemplo mínimo
---
title: "Meu Documento"
author: "Blog do Marcellini"
format: html
---1.4 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.
1.5 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 |
1.6 Exemplo completo
---
title: "Análise de Dados com R"
author: "Blog do Marcellini"
date: 2025-06-23
format: html
lang: pt-BR
toc: true
execute:
engine: knitr
echo: true
warning: false
message: false
---1.7 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).
1.8 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.
← Voltar para o Guia de Leitura de Programação 👨💻
← Voltar para a Seção de Quarto 📄
← Voltar para a Seção de Programação 👨💻
Blog do Marcellini — Explorando a Matemática, a Estatística e a Física com Rigor e Beleza.
Criado por Blog do Marcellini com ❤️ e código.