📘 👨‍💻 📄 YAML no Quarto: O Coração Invisível dos Seus Documentos

programação
YAML
Quarto
artigo
O YAML é a primeira coisa que aparece em um documento .qmd — mas para muitos, é também a mais misteriosa.
Autor

Blog do Marcellini

Data de Publicação

29 de junho de 2025

· ← Guia de Leitura de Programação · ← Seção de Quarto

· ← Seção de Programação

YAML

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.

· ← Guia de Leitura de Programação · ← Seção de Quarto

· ← Seção de Programação · 🔝 Topo

Blog do Marcellini — Explorando a Matemática, a Estatística e a Física com Rigor e Beleza.

Nota

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