1  Introdução

1.1 Você já usa Markdown sem saber

Quando você escreve uma palavra entre asteriscos no WhatsApp e ela aparece em negrito, você está usando uma convenção prima do Markdown. A própria central de ajuda do aplicativo ensina a receita: asteriscos para negrito, sublinhados para itálico, til para texto riscado, crase para texto de máquina (WhatsApp LLC, 2026). Não é exatamente o Markdown, que pede dois asteriscos para o negrito e um só para o itálico, mas a ideia é a mesma: uma marca no próprio texto diz como ele deve aparecer. Quando o ChatGPT responde com um título, uma lista de itens e algumas palavras em destaque, ele escreveu Markdown: os modelos de linguagem, por padrão, produzem exatamente esse formato, e a tela apenas o converte em texto formatado (Willison, 2025).

Ou seja, você já viu Markdown centenas de vezes. Ele é uma convenção para indicar estrutura num texto comum: um asterisco aqui, uma hashtag ali, o sinal #,1 um traço no começo da linha. Só isso. A lista completa dessas marcas está em Capítulo 6. Por enquanto, basta saber que este livro não vai lhe ensinar uma linguagem nova. Vai lhe ensinar o nome de uma que você já usa, e o que se pode fazer com ela quando se leva a sério.

1.2 Para que serve este livro

Quantas versões do seu último trabalho existem no seu computador? E qual delas é a boa?

Este livro é para quem escreve muito e precisa publicar: artigos, teses e dissertações, apostilas, livros, páginas de disciplina, apresentações. Para quem revisa o mesmo texto ano após ano e não quer perder o fio. E para quem, até hoje, fez tudo isso dentro de um processador de texto, porque era o que havia.

Ao terminar, você será capaz de escrever em texto puro e gerar dele, sem reescrever nada, um documento em PDF ou em Word, um site ou uma apresentação. Vai poder usar a norma de citação que quiser, ABNT, Vancouver, APA ou a de uma revista específica, trocando uma linha de configuração. Vai publicar na web sem depender de ninguém. E vai trabalhar com um assistente de inteligência artificial sem perder o controle do que ele escreve nem das fontes que ele cita.

Antes de seguir, uma definição, porque a expressão vai aparecer em cada página. Um arquivo de texto puro contém apenas os caracteres que você digitou: letras, números, pontuação, quebras de linha. Nada de formatação escondida, nada que só um programa específico saiba interpretar. Qualquer editor abre, em qualquer máquina, hoje ou daqui a décadas. Um documento de um processador de texto, como o Word, muitas vezes não abre direito depois de várias versões e atualizações. O Markdown é texto puro com algumas convenções por cima, e o Quarto é o programa que amplia as possibilidades de uso desse texto.

1.3 O que o Word não faz bem

O Word é um programa excelente para o que foi feito: uma carta, um ofício, um relatório de dez páginas que vai ser impresso uma vez. Não é dele o problema. O problema é o que pedimos a ele.

Um documento longo e vivo, como uma tese ou um livro, tem numeração de capítulos e figuras, sumário, referências cruzadas, centenas de citações. No Word, cada uma dessas coisas funciona até o dia em que deixa de funcionar: o estilo que alguém aplicou diferente, o número que não atualiza, a figura que pula de página quando o arquivo abre em outro computador. Depois vem o problema das versões. Você reconhece tese_final_v3_revisada_DEFINITIVA2.docx. O controle de alterações ajuda, mas mistura a história do texto com o texto, e não há como comparar duas versões sem abrir o programa. Por fim, o Word produz uma coisa só: a página impressa. Se o mesmo conteúdo precisa virar uma página na web, um livro eletrônico ou uma apresentação, o trabalho recomeça.

Todos esses problemas têm uma raiz comum, e ela vai ficar clara em Capítulo 2: o processador de texto mistura o que você diz com a aparência do que você diz, no mesmo arquivo, sem que você veja o código por trás. Mas você não precisa abandonar o Word. Quando a secretaria da pós-graduação exigir um .docx, o Quarto produz um a partir do seu texto puro, e você continua escrevendo do jeito novo.

1.4 Arquivos que dependem de um programa

O custo mais visível é o dinheiro. O pacote Office é vendido hoje por assinatura, paga todo ano, com o Word dentro (Microsoft Corporation, 2026). Mas o custo maior é outro.

Um arquivo .docx é, por dentro, um pacote comprimido de vários arquivos em um formato chamado Office Open XML, descrito numa norma técnica pública de centenas de páginas (Ecma International, 2021). Por ser pública, outros programas também o abrem. Mas nenhuma pessoa o lê a olho nu: para ler, comparar duas versões, consertar um defeito ou simplesmente saber o que mudou, sempre há um programa entre você e o seu texto, e é ele que decide o que você vê. Quem decide o futuro do formato, o que continua abrindo e o que deixa de abrir, é quem o mantém, não você.

O texto puro inverte a relação. O arquivo é seu no sentido mais prático: qualquer editor abre, qualquer pessoa lê, qualquer diferença entre duas versões aparece linha a linha, e nada disso exige um programa específico. Não há intermediário entre você e o que você escreveu.

1.5 Gerenciadores de referência

Com a bibliografia acontece o mesmo. O EndNote, o gerenciador mais tradicional, é vendido por licença paga, em compra única, com desconto para estudante (Clarivate, 2026). O Mendeley é gratuito, mas pertence a uma editora comercial, e o destino do programa é decidido por ela: em 2022 a empresa anunciou o fim da distribuição da versão de mesa, substituída por um programa novo (Mendeley, 2022), e em 2026 a versão antiga ainda pode ser baixada, mas sem atualizações e com aviso de que o acesso será encerrado quando a empresa decidir (Elsevier, 2026). O programa existe enquanto a empresa quiser. Nos dois casos a sua biblioteca de referências vive num banco de dados em formato próprio, atrelado a um complemento do Word. Se o programa muda, a biblioteca vai junto.

A alternativa é a mesma de sempre: texto puro. A bibliografia inteira cabe num arquivo de texto, uma entrada por obra, que qualquer gerenciador importa e exporta e que sobrevive a todos eles. O Zotero, gratuito e de código aberto, mantido por uma organização sem fins lucrativos (Corporation for Digital Scholarship, 2026a), faz esse papel muito bem, e é o que este livro usa. Os detalhes estão em Capítulo 13.

1.6 A IA não tem mouse

O Word foi feito para uma pessoa com um mouse na mão: clica no botão, escolhe a fonte, arrasta a figura. A inteligência artificial não tem mouse. Há, é verdade, sistemas que já movem um cursor pela tela e clicam em botões para operar programas como uma pessoa faria (Anthropic, 2024), mas isso é um andaime construído em volta do modelo. O que um modelo de linguagem faz de nativo, e faz bem, é uma coisa só: ler texto e escrever texto. É nessa diferença que está o argumento central deste livro: o texto puro é a única forma em que você e o assistente trabalham sobre a mesma fonte, e em que você consegue inspecionar o que ele fez.

Para que um assistente de IA “leia” o seu .docx ou o seu PDF, alguém precisa converter o arquivo em texto antes. E a conversão perde coisas: títulos viram linhas soltas, tabelas viram uma sopa de células, notas de rodapé caem no meio de um parágrafo, as duas colunas de um artigo em PDF se embaralham. O que sai do outro lado é uma versão empobrecida do que você escreveu, e é sobre ela que o modelo vai trabalhar.

A conversão também custa. Um modelo de linguagem processa o texto em pedaços chamados tokens, mais ou menos uma sílaba ou uma palavra curta cada, e é por token que se paga. Em agosto de 2026, uma reportagem sobre empresas tentando conter os gastos com IA registrou que parte considerável do consumo vinha da conversão de PDFs para Markdown; ao comentá-la, Simon Willison resumiu que o PDF é “um meio terrível para comunicar informação” (Willison, 2026). Vale registrar desde já: o PDF é um formato de leitura e de impressão, ótimo para isso. Como lugar de escrever e editar, é o pior de todos, e a IA sofre com ele tanto quanto você.

O caminho de volta é ainda pior. A IA devolve texto. Se o seu documento está no Word, alguém precisa colar esse texto e conferir a formatação. Se o seu documento está em Markdown, o que a IA escreve já é o arquivo, na mesma forma em que você o escreveria; e, se você guarda a história desse arquivo, como Capítulo 19 ensina, cada alteração que ela fez aparece linha a linha, para você aceitar ou recusar. Jeremy Howard, ao propor um padrão para que sites conversem com modelos de linguagem, observou que uma página da web embrulha a informação em menus, anúncios e código, e que “o formato mais ampla e facilmente entendido pelos modelos de linguagem é o Markdown” (Howard, 2024). As razões para isso, e o que elas mudam na maneira de escrever, são o assunto de Capítulo 3.

1.7 Tudo neste livro é gratuito e aberto

Nada do que este livro ensina custa dinheiro. O próprio Markdown não pertence a ninguém, e o Quarto, o Zotero, o Git, o LaTeX, o R e o Python são programas livres, com código público. A única exceção é o GitHub, onde o livro fica hospedado: é um serviço comercial com plano gratuito para repositórios públicos, e o que você guarda nele continua sendo texto puro, que pode ir para qualquer outro lugar. Você pode instalar tudo hoje, em qualquer sistema, sem cartão de crédito; e se qualquer dessas ferramentas desaparecer amanhã, seus arquivos continuam legíveis por qualquer outra.

1.8 Não é necessário saber programar

O que o livro não pede: que você programe. Não há uma linha de código a escrever nos capítulos necessários para escrever e publicar; quando o código aparece, em Capítulo 12, é como possibilidade para quem quiser, não como exigência.

Se você está começando do zero, leia na ordem. Se já escreve em Markdown, pode saltar para a Parte 2, onde o Quarto entra. Se já usa o Quarto e quer resolver um problema específico, a Parte 3 em diante e os apêndices são de consulta.

1.9 Convenções

  • Comandos aparecem em blocos de código e devem ser digitados na pasta do projeto.
  • Nomes de arquivo, pastas e opções de configuração aparecem em fonte monoespaçada.
  • Os avisos ao longo do texto distinguem o que é nota, dica, atenção e cuidado; o formato deles é explicado em Capítulo 11.
NotaPontos-chave
  • Você já usa convenções primas do Markdown, no WhatsApp e nas respostas da IA; este livro ensina o nome e o alcance dele.
  • Texto puro é um arquivo só com os caracteres que você digitou: qualquer editor abre, qualquer pessoa compara, nenhum programa fica entre você e o texto.
  • O Word é ótimo para o que foi feito; para documentos longos e vivos, ele esconde a estrutura e produz uma saída só. Arquivos e bibliotecas em formato próprio dependem do programa que os mantém. Você não abandona o Word; passa a gerá-lo a partir do Quarto.
  • Um modelo de linguagem lê e escreve texto. Converter Word e PDF perde estrutura e custa tokens; Markdown é o formato que ele entende melhor, e o que ele escreve já é o arquivo.
  • Todas as ferramentas do livro são gratuitas e, com exceção do serviço de hospedagem, de código aberto; o que se pede é alguns dias de estranhamento, não programação.

  1. Em inglês, o sinal # tem vários nomes, e cada um vem de um uso: number sign, porque “#5” se lê “número cinco”; pound sign, porque na América do Norte “5#” era “cinco libras de peso”; e hash sign, o nome britânico, pelo hachurado do desenho (Houston, 2011). A hashtag é a etiqueta que o sinal forma com a palavra colada a ele, como em #barcamp: o uso foi proposto em 2007 por Chris Messina para agrupar mensagens no Twitter, copiando os canais dos antigos bate-papos da internet (Messina, 2007). Em português, os dicionários registram o sinal como “cerquilha”, de “cerca” mais um diminutivo, ou “cardinal” (Priberam, 2026), nomes que quase ninguém usa no Brasil. A palavra hashtag chegou pelas redes sociais, sempre com o sinal na frente, e o sinal acabou herdando o nome da etiqueta, a ponto de o Cambridge Dictionary definir hashtag, em primeiro lugar, como “o sinal # num telefone ou teclado de computador” (Cambridge University Press, 2026). Este livro segue o uso.↩︎