5 Instalação e ferramentas – Manual de Markdown e Quarto

5.1 O terminal

Antes de instalar, uma palavra sobre onde você vai digitar os comandos. O terminal é o programa em que se dão ordens ao computador por escrito: você digita uma linha, aperta Enter e lê a resposta. No macOS ele se chama Terminal e fica na pasta Utilitários, dentro de Aplicativos; no Windows, procure Terminal ou PowerShell no menu Iniciar. Quando este livro mostra um bloco como o abaixo, é para digitar ali:

quarto --version

Você não precisa saber mais do que isso sobre o terminal. Os comandos do livro são poucos e sempre vêm prontos para copiar. Os editores da seção seguinte fazem o resto por botões.

5.2 Quarto

O Quarto se instala com um instalador comum, de clicar e avançar. A página de download em quarto.org mostra a tabela de sistemas (Posit Software, PBC, 2026c); os arquivos vêm da página de lançamentos do projeto (Quarto Development Team, 2026).

No macOS, baixe o arquivo .pkg, abra-o e siga o instalador. Ele coloca o Quarto na pasta /Applications/quarto e deixa o comando quarto disponível no Terminal.

No Windows, baixe o arquivo .msi, abra-o e siga o instalador. Ao terminar, feche e abra de novo o terminal, para que ele enxergue o comando novo.

No Linux, há pacotes .deb e .rpm para as distribuições mais comuns, e um .tar.gz para as outras (Quarto Development Team, 2026).

Quando o instalador terminar, confira no terminal:

quarto --version

A resposta é o número da versão. Em setembro de 2026 a versão corrente era a 1.10.18 (Quarto Development Team, 2026); se a sua for mais nova, tudo bem. Se em vez de um número aparecer uma mensagem de comando não encontrado, feche o terminal, abra outro e tente de novo.

O que veio junto

O Quarto traz dentro dele tudo o que precisa para produzir páginas da web, documentos do Word, apresentações e PDF pelo Typst, o compositor apresentado em Capítulo 4. O programa que faz a conversão entre formatos chama-se Pandoc: o Quarto “é construído sobre o Pandoc” e usa a variação de Markdown dele como sintaxe (Posit Software, PBC, 2026b, 2026d). Você não instala o Pandoc nem o chama diretamente; mas o nome vai aparecer em mensagens de erro e na documentação, e Capítulo 6 volta a ele, porque é o dialeto de Markdown que você vai escrever.

O comando abaixo lista o que está instalado e o que falta:

quarto check

Ele confere as versões do próprio Quarto, do Pandoc e do Typst, testa a geração de um documento simples e depois procura, um a um, o LaTeX, o R, o Python e o Julia. Cada item que ele não encontra aparece como não instalado. Isso é normal e não é erro: são recursos opcionais, e nenhum deles é necessário para escrever texto.

PDF pelo LaTeX

O Typst gera PDF sem instalar nada. Se você precisar do LaTeX, seja porque uma revista exige, seja porque um modelo de tese foi feito para ele, o Quarto instala uma distribuição mínima com um comando:

quarto install tinytex

O TinyTeX é uma distribuição do TeX Live com os duzentos pacotes mais usados, num download inicial de cerca de 100 MB, e é o caminho que a documentação do Quarto “recomenda fortemente” (Posit Software, PBC, 2026e). Quem já tem uma instalação de LaTeX pode continuar com ela. Não instale agora por precaução: instale quando um documento pedir.

5.3 Editor

Qualquer editor de texto serve, como diz Capítulo 4. Mas o Quarto tem uma extensão oficial para o VS Code que faz muita diferença para quem começa: ela gera e mostra o documento ao lado do texto, colore a sintaxe, completa as opções de configuração e avisa de erros (Posit Software, PBC, 2026h).

VS Code. Baixe em code.visualstudio.com, para Windows, macOS ou Linux; é gratuito e construído sobre código aberto (Microsoft, 2026). Instalado o editor, abra o painel de extensões, o ícone de blocos na barra lateral, procure por “Quarto” e instale a extensão publicada por Quarto. Ela também está no catálogo do VS Code na web e no Open VSX, para quem usa variantes do editor (Posit Software, PBC, 2026h).

Com a extensão, abra qualquer arquivo .qmd e aperte Ctrl+Shift+K, ou Cmd+Shift+K no macOS, ou clique no botão Preview no canto superior direito: o documento gerado aparece num painel ao lado, e cada vez que você salvar, ele se atualiza (Posit Software, PBC, 2026g).

Positron. É um editor da Posit, a mesma empresa do Quarto, feito para ciência de dados em Python e R, gratuito, para macOS 11 em diante, Windows 10 em diante e Linux (Posit Software, PBC, 2026a). Ele “inclui tanto o Quarto quanto a extensão do VS Code para o Quarto, e por isso já vem pronto para trabalhar com o Quarto” (Posit Software, PBC, 2026f). Se você escolher o Positron, a extensão já está lá. Instale o Quarto mesmo assim, pela seção anterior, para que os comandos deste livro funcionem no terminal.

Este livro usa o VS Code nos exemplos. O Positron se comporta da mesma maneira, e o editor visual dos dois, para quem prefere ver o texto formatado, está descrito em Capítulo 4.

5.4 Git e GitHub

O Git guarda a história de cada arquivo; o GitHub hospeda o repositório na nuvem e publica o site. O uso dos dois é o assunto de Capítulo 19; aqui só a instalação.

No macOS, o caminho mais simples é pedir ao próprio sistema as ferramentas de linha de comando da Apple, que trazem o Git (Git Project, 2026a):

xcode-select --install

Uma janela pede confirmação e faz o download. Quem usa o Homebrew, um instalador de programas para o terminal, pode preferir brew install git (Git Project, 2026a).

No Windows, baixe o instalador do Git for Windows na página oficial, na versão de 64 bits ou ARM64 conforme a máquina, e siga o assistente; ele faz muitas perguntas, e as respostas padrão servem. Quem prefere o terminal instala pelo winget, o instalador de programas do Windows (Git Project, 2026b):

winget install --id Git.Git -e --source winget

Nos dois sistemas, confira:

git --version

Depois, diga ao Git quem você é. Todo registro que ele fizer leva esse nome e esse e-mail, e a documentação do Git chama isso de “a primeira coisa que você deve fazer” ao instalá-lo (Chacon; Straub, 2014):

git config --global user.name "Seu Nome"
git config --global user.email "seu@email"

Use o mesmo e-mail que vai usar na conta do GitHub, para que o site reconheça o que é seu.

Conta no GitHub. Vá a github.com/signup, siga as instruções e confirme o endereço de e-mail que ele envia; sem a confirmação, a conta não cria repositórios (GitHub, Inc., 2026a). A conta gratuita basta para tudo o que este livro faz, inclusive publicar o site (GitHub, Inc., 2026b). Escolha o nome de usuário com calma: ele aparece no endereço de tudo o que você publicar.

5.5 Python e R

Um documento do Quarto pode executar código em Python, R ou Julia e inserir o resultado no texto (Capítulo 4). Para isso, a linguagem precisa estar instalada, e quarto check diz se ela foi encontrada. Nada disso é necessário para escrever, citar e publicar: o livro que você está lendo não tem uma linha de código executável. Quando o assunto for código, Capítulo 12 explica o que instalar.

5.6 Conferindo tudo

Ao fim da instalação, estes quatro comandos, digitados no terminal, dizem se cada peça está no lugar:

Comando	Resposta esperada
`quarto --version`	um número de versão, 1.10.18 ou mais novo
`quarto check`	uma lista com OK ao lado de Quarto, Pandoc e Typst
`git --version`	um número de versão
`git config --global user.name`	o seu nome

Se as quatro respostas vierem, o próximo capítulo já pode ser lido com um arquivo aberto no editor.

Pontos-chave

Três programas gratuitos: o Quarto, um editor e o Git; e uma conta gratuita no GitHub. Instaladores comuns no macOS e no Windows.
O Quarto traz dentro o Pandoc, o conversor entre formatos, e o Typst, que gera PDF sem instalar nada; o LaTeX é opcional e se instala com um comando quando um documento pedir.
O VS Code com a extensão Quarto mostra o documento ao lado do texto; o Positron já vem com os dois.
Depois de instalar o Git, informe nome e e-mail: todo registro leva os dois.
Python e R só importam se o documento executar código.