4 Quarto
O Quarto é um sistema de publicação, gratuito e de código aberto que recebe um texto em Markdown e o transforma no que você precisar: um artigo, uma tese, um livro, um site, uma apresentação, um painel de dados (Posit Software, PBC, 2026b). Ele é mantido pela Posit, a empresa que fez o R Markdown, e se apresenta como a nova geração dele: a mesma ideia de Capítulo 3, texto e código no mesmo arquivo, agora para qualquer linguagem e sem exigir nenhuma (Posit Software, PBC, 2026h).
4.1 Um texto, todos os formatos
A ideia central é escrever uma vez e gerar o que for preciso depois. O mesmo arquivo pode virar uma página da web, um PDF, um documento do Word, um documento do LibreOffice ou um livro eletrônico em ePub; pode virar slides em HTML, em PowerPoint ou em PDF; e pode ser convertido para dezenas de outros formatos, de wikis a variantes de Markdown que alimentam outros sistemas (Posit Software, PBC, 2026a). A escolha é uma linha de configuração.
O PDF merece uma nota. Ele pode ser produzido por dois caminhos: pelo LaTeX, o sistema de Capítulo 2, que exige uma instalação à parte, ou pelo Typst, um compositor mais novo, feito “para ser tão poderoso quanto o LaTeX e muito mais fácil de aprender e usar”, que já vem dentro do Quarto e não precisa ser instalado (Posit Software, PBC, 2026o). Para quem está começando, o Typst resolve o PDF no primeiro dia.
4.2 O que dá para fazer
Um documento avulso. Um artigo, um relatório, um parecer, uma prova. Um arquivo só, com título, seções, figuras, tabelas, notas de rodapé e citações, que sai em PDF quando é para imprimir e em Word quando alguém exige.
Um artigo científico. Equações, referências cruzadas a figuras e tabelas, citações em qualquer norma, tudo faz parte da linguagem. Os formatos exigidos por revistas e editoras, como ACM, PLOS e Elsevier, existem como complementos que se instalam com um comando (Posit Software, PBC, 2026j). E há um tipo de projeto feito para isso, o manuscrito, cujo resultado é um site do artigo com as versões em PDF e Word, os cadernos de código que produziram os resultados e um pacote único “adequado para enviar a um editor” (Posit Software, PBC, 2026k).
Uma tese, uma dissertação, um livro. O tipo de projeto livro “combina vários documentos (capítulos) em um só manuscrito”, com partes, numeração de capítulos, referências cruzadas entre eles, bibliografia e busca no texto, e produz HTML, PDF, Word e ePub a partir dos mesmos arquivos (Posit Software, PBC, 2026d).
Um site ou um blog. Um site do Quarto é “uma maneira conveniente de publicar grupos de documentos”, que compartilham a navegação, as opções e o estilo visual, com menu, barra lateral e busca (Posit Software, PBC, 2026e). Serve para a página de uma disciplina, o site de um laboratório, a documentação de um programa ou um blog pessoal, com a listagem de posts pronta.
Uma apresentação. Slides em três formatos: HTML, PowerPoint e PDF. Os títulos do texto viram os slides, as listas podem aparecer item a item, e o conteúdo pode ir em colunas (Posit Software, PBC, 2026m).
Um painel de dados. O tipo painel dispõe gráficos, tabelas, indicadores e anotações numa grade, em Python, R, Julia ou Observable JavaScript, e pode ser publicado como página estática, “sem necessidade de servidor especial”, ou com um servidor por trás para mais interatividade (Posit Software, PBC, 2026f).
Um documento que calcula. Um arquivo do Quarto pode conter trechos de código em Python, R, Julia ou Observable JavaScript. Ao gerar o documento, o código é executado, e o resultado, um número, uma tabela, um gráfico, entra no lugar certo (Posit Software, PBC, 2026b). É o documento reprodutível de Capítulo 3: quem tem a fonte e os dados regenera tudo, e nenhum número é copiado à mão. Páginas na web podem ainda incluir elementos que respondem ao leitor, alguns sem servidor nenhum (Posit Software, PBC, 2026i).
4.3 Bibliografia e Citações
A bibliografia é um arquivo de texto, uma entrada por obra, no formato bibtex. Cada citação no texto é uma chave que aponta para uma entrada.
4.4 Estilos
O estilo a ser usado nas citações e referencias é um arquivo a parte. Existem mais de 8.500 estilos públicos, mantidos num repositório aberto e no acervo do Zotero, cobrindo as principais normas e milhares de revistas (Posit Software, PBC, 2026c). Trocar a norma do documento inteiro, de ABNT para APA, para Vancouver ou para o estilo de uma revista, é trocar essa linha. O padrão de fábrica é o Chicago autor-data (Posit Software, PBC, 2026c).
4.5 Onde escrever
O Quarto não é um aplicativo com janela própria. É um comando instalado no computador, e o texto se escreve em qualquer editor: a documentação diz que, para documentos sem código, você pode usar “o seu editor de texto favorito” e gerar o resultado pelo terminal (Posit Software, PBC, 2026p). Mas há editores que já vêm preparados para ele, como o VS Code e o Positron: um botão ou um atalho gera o documento e mostra o resultado ao lado do texto, sem terminal nenhum, e o Positron já traz o Quarto dentro (Posit Software, PBC, 2026r, 2026l). É o caminho que este livro recomenda.
Quem prefere ver o texto formatado enquanto escreve tem o editor visual, disponível no RStudio, no VS Code e no Positron (Posit Software, PBC, 2026q, 2026r, 2026l). Ele mostra tabelas, citações, referências cruzadas e notas de rodapé já formatadas, com menus e botões, e um botão alterna entre esse modo e o Markdown. O arquivo não muda: a documentação avisa que o editor “não tenta abstrair nem esconder o documento Markdown que está por baixo” (Posit Software, PBC, 2026q). A tela é a de um processador de texto; o arquivo continua texto puro. Capítulo 5 ajuda a escolher.
4.6 Publicar
Um comando envia o resultado para um dos serviços que o Quarto conhece: GitHub Pages, Quarto Pub, Netlify, Posit Connect, Confluence, Hugging Face Spaces (Posit Software, PBC, 2026n). Os dois primeiros são gratuitos, e o GitHub Pages é o que publica este livro. Como a saída é uma página da web comum, qualquer servidor serve; e é possível automatizar tudo, de modo que cada alteração na fonte gere e publique o site sozinha, sem intervenção sua (Posit Software, PBC, 2026n). A Parte 6 percorre esse caminho.
4.7 O que falta vem por extensão
O que o Quarto não faz de fábrica costuma existir como extensão: formatos de revistas, formatos personalizados, recursos extras para slides, tipos de projeto, modelos de partida e pequenos comandos que acrescentam sintaxe (Posit Software, PBC, 2026g). Uma extensão se instala com um comando, por projeto, e fica guardada junto com a fonte, de modo que quem clona o projeto leva tudo. Há um catálogo público delas.
- O Quarto é um sistema gratuito e de código aberto, mantido pela Posit, que transforma um texto em Markdown em documentos, artigos, teses, livros, sites, apresentações e painéis.
- Uma fonte gera todos os formatos: web, PDF, Word, ePub, slides e dezenas de outros; a escolha é uma linha de configuração, e o PDF sai no primeiro dia com o Typst, que já vem dentro.
- Código em Python, R, Julia ou Observable JavaScript pode ser executado dentro do documento, o que o torna reprodutível; mas o código é opcional.
- A bibliografia é texto e a norma é um arquivo trocável, entre mais de 8.500 estilos públicos.
- Escreve-se em qualquer editor, ou no editor visual para quem prefere ver o texto formatado; um comando publica na web, e extensões cobrem o que falta.