6 Sintaxe

O Markdown é a linguagem em que os capítulos são escritos. O dialeto usado pelo Quarto é o do Pandoc (MacFarlane, 2026), que estende o Markdown original com tabelas, notas de rodapé, citações, atributos e blocos delimitados. Este capítulo cobre o que os livros da casa usam.

6.1 Parágrafos e ênfase

Um parágrafo é um bloco de texto separado por uma linha em branco. Quebras de linha simples dentro do parágrafo são ignoradas, o que permite escrever cada frase em uma linha se preferir; o script code/unwrap_paragraphs.py desfaz essas quebras quando o texto vem de outra origem. Uma barra invertida no fim da linha força a quebra (útil em versos e epígrafes).

Texto em *itálico* e em **negrito**. Termo estrangeiro em *itálico*;
`código` em fonte monoespaçada. Nota de rodapé.[^1]

[^1]: Texto da nota, que pode ficar no fim do arquivo.

6.2 Títulos

Os títulos usam hashtags: # para o capítulo, ## para as seções, ### para as subseções. A casa numera até o segundo nível (number-depth: 2); títulos além disso ficam sem número. A convenção para o título do capítulo, com identificador, está em Capítulo 9.

6.3 Listas

- Item de lista com marcador
- Outro item
  - Subitem, indentado com dois espaços

1. Item numerado
2. Outro item

6.4 Links e imagens

[texto do link](https://quarto.org)
[link interno para uma seção](#sec-sintaxe)
![Legenda da figura](images/figura.png){#fig-rotulo fig-alt="Descrição para leitores de tela"}

Links externos abrem em nova aba por configuração do livro (link-external-newwindow: true). Figuras com identificador #fig- ganham número e podem ser citadas (Capítulo 10).

6.5 Citações em bloco

Uma linha iniciada por > vira um bloco de citação, usado nas epígrafes dos capítulos:

> *Selection is the very keel on which our mental ship is built.*
>
> — William James, *The Principles of Psychology*

6.6 Tabelas

A forma mais simples é a tabela com barras verticais. A linha de legenda começa com dois-pontos e pode levar atributos:

| Coluna A | Coluna B |
|---|---|
| valor | valor |

: Legenda da tabela {#tbl-rotulo .striped tbl-colwidths="[30,70]"}

6.7 Blocos delimitados e atributos

Três dois-pontos abrem um bloco (fenced div) com classe e atributos; é a sintaxe dos callouts (Capítulo 11) e das seções da página de créditos:

::: {.about-section}
## Conteúdo do bloco
:::

Chaves logo após um título, uma imagem ou um link acrescentam identificador, classes e atributos: {#sec-id .unnumbered}.

6.8 Comentários

Comentários HTML não aparecem no livro renderizado e são o canal de recados entre o autor, os revisores e a IA (Capítulo 22):

<!-- AUTOR (2ª ed.): revisar esta seção. -->

6.9 Cabeçalho YAML

Um bloco entre duas linhas de --- no início do arquivo define opções da página: título, sumário local, numeração. Os capítulos da casa raramente precisam dele, porque o título vai no heading; as páginas sem número (prefácio, créditos, referências) usam number-sections: false.

Pontos-chave

O Markdown do Pandoc cobre parágrafos, ênfase, listas, links, notas, tabelas e blocos delimitados.
Identificadores e classes vão entre chaves logo após o elemento.
Comentários HTML são invisíveis no livro e servem de recado editorial.
O cabeçalho YAML é opcional nos capítulos e obrigatório nas páginas sem número.