2 Markdown
Markdown é um jeito de escrever texto formatado num arquivo de texto comum. Em vez de clicar num botão para fazer um título, você põe uma hashtag no começo da linha; em vez de clicar em negrito, põe a palavra entre dois asteriscos; em vez de um botão de lista, começa cada item com um traço.
Isto é Markdown:
# Sobre a memória
A memória não é um **arquivo**; é uma *reconstrução*.
- primeiro ponto
- segundo pontoA hashtag diz “isto é um título”; os asteriscos dizem “isto tem ênfase”, dois para o negrito e um para o itálico; os traços dizem “isto é uma lista”. Um programa transforma essas sete linhas num título grande, num parágrafo com uma palavra em negrito e outra em itálico, e numa lista com dois itens. Mas, mesmo sem programa nenhum, você acabou de ler o trecho sem esforço. Essa é a única ideia do Markdown, e o resto deste capítulo conta de onde ela veio.
O Markdown foi criado por John Gruber para escrever texto formatado sem sair do texto puro. Hoje é o formato do GitHub, do Stack Overflow, do Reddit, das respostas do ChatGPT e, em parte, até do WhatsApp.
2.1 O que você vê é tudo o que você tem
No início dos anos 1970, no centro de pesquisas da Xerox em Palo Alto, um engenheiro chamado Charles Simonyi criou o Bravo, o primeiro editor de texto em que a tela mostrava a página exatamente como ela sairia impressa (Computer History Museum, 2026a, 2026b). A sigla que batizou a ideia, WYSIWYG, what you see is what you get, “o que você vê é o que você obtém”, virou o padrão de tudo o que veio depois. Simonyi levou a ideia para a Microsoft e foi o arquiteto-chefe do Word (Computer History Museum, 2026a). O processador de texto que está no seu computador é aquele editor de 1970 transformado em produto.
A ideia é sedutora, e por um bom motivo: para uma carta ou um memorando, ver a página enquanto se escreve é tudo o que se precisa. O problema aparece quando o documento cresce. Leslie Lamport, de quem falaremos daqui a pouco, resumiu a limitação numa frase que ele atribui a Brian Reid: WYSIWYG é, na verdade, what you see is all you’ve got, “o que você vê é tudo o que você tem” (Lamport, 1994, p. 7). O que o programa guarda com certeza é a aparência de cada trecho: negrito aqui, catorze pontos ali. Ele também pode guardar o que o trecho é, por meio dos estilos, e a figura deste capítulo mostra um deles, Heading1, dentro do arquivo; quem aplica os estilos com disciplina obtém sumário e numeração automáticos. O problema é que essa estrutura é opcional e invisível. Nada impede que um título seja só uma linha em negrito, e nada no que você vê distingue as duas coisas. Num documento longo, revisado por várias mãos, as duas convivem, e é aí que o sumário falha e a numeração se perde. Nas palavras de Lamport, o desenho visual “é bom para documentos curtos e simples, como cartas e memorandos. Não é bom para documentos mais complexos, como artigos científicos” (Lamport, 1994, p. 7).
2.2 Isto é um título
A ideia oposta nasceu na mesma década, do outro lado do país. Em 1980, Brian Reid defendeu na Universidade Carnegie Mellon uma tese sobre um sistema chamado Scribe (Reid, 1980). O resumo começa com um diagnóstico que parece escrito ontem: usar computadores para editar e formatar documentos tinha um “efeito colateral perturbador”, o de que “a responsabilidade pela aparência do documento acabado, que antes cabia a editores de produção, revisores, designers gráficos e tipógrafos, está nas mãos do escritor, e não da equipe de produção” (Reid, 1980, p. i).
A resposta de Reid foi separar as duas coisas. No Scribe, “o escritor prepara um texto de manuscrito que não contém nenhuma menção a formato específico”; esse texto diz apenas o que cada parte é, um título, uma citação, uma nota, e um programa o combina com um conjunto de regras de aparência preparadas por um designer, produzindo “um documento que contém o texto do autor no formato do designer” (Reid, 1980, p. i). É o que se chama de marcação lógica: em vez de “catorze pontos, negrito, centralizado”, o autor escreve “isto é um título”. A aparência de todos os títulos vive num só lugar, e mudar o desenho do livro inteiro é mudar esse lugar.
Pense no que isso significa para quem escreve. O escritor volta a fazer o que sabe fazer, dizer o que o texto é, e devolve ao sistema a tarefa de fazê-lo parecer bem. A ideia se espalhou.
2.3 O exemplo de Kronecker
Quem a espalhou de forma mais duradoura foi Leslie Lamport. Em 1985 apareceu a primeira versão do LaTeX (Lamport, 1994, p. 2), um sistema de preparação de documentos usado até hoje em matemática, física e computação. No manual, Lamport explica a marcação lógica com um exemplo que vale a pena repetir aqui, porque dispensa qualquer conhecimento técnico.
Imagine um manuscrito datilografado com dois parágrafos recuados. O primeiro é uma citação de um matemático, Kronecker, dizendo que Deus criou os números inteiros. O segundo é um pequeno programa de computador. Um designer humano sabe, ao ler, que o primeiro é uma citação e o segundo é um programa, e vai compô-los de maneiras diferentes: a citação em tipo comum, o programa em tipo de máquina de escrever. Um computador não sabe. “O LaTeX é só um programa e não entende inglês, então não consegue descobrir isso sozinho. Ele precisa de mais ajuda sua do que um designer humano precisaria” (Lamport, 1994, p. 6). Essa ajuda é a marcação: você diz “isto é uma citação”, “isto é um programa”, e o sistema faz o resto.
E a razão de tudo isso, ainda nas palavras de Lamport: “a função do desenho tipográfico é ajudar o leitor a entender as ideias do autor. Para um documento ser fácil de ler, sua estrutura visual precisa refletir sua estrutura lógica” (Lamport, 1994, p. 6). As páginas da web seguem o mesmo princípio: por baixo de qualquer página há marcas que dizem o que cada coisa é, um título, um parágrafo, um link, e o navegador decide como mostrá-las. A linhagem de Reid chegou a todo mundo que abre um navegador.
2.4 Legível como um e-mail
A marcação lógica funciona, mas o texto marcado é feio de ler: comandos entre barras e chaves no LaTeX, etiquetas entre sinais de menor e maior nas páginas da web. O autor escreve olhando para uma coisa e o leitor lê outra.
Em 2004, John Gruber, com a colaboração de Aaron Swartz, propôs uma solução simples (Gruber, 2004). Em vez de inventar marcas novas, ele adotou as que as pessoas já usavam havia décadas nos e-mails em texto puro: asteriscos para dar ênfase, um sinal de maior no começo da linha para citar alguém, traços para fazer uma lista. “A maior fonte de inspiração para a sintaxe do Markdown é o formato do e-mail em texto puro”, escreveu ele, e o objetivo dominante era “torná-la o mais legível possível”. A frase que define o projeto: “um documento formatado em Markdown deve ser publicável como está, em texto puro, sem parecer que foi marcado com etiquetas ou instruções de formatação” (Gruber, 2004).
O que Gruber publicou, além da descrição, foi um pequeno programa que convertia esse texto em página da web (Gruber, 2004).
A Figura 2.1 mostra o que isso significa na prática. O mesmo trecho aparece três vezes: como você o vê na tela, como um arquivo .docx o guarda por dentro e como o Markdown o guarda. A coluna do meio não foi inventada: é o conteúdo real do pacote gerado a partir do texto da direita. Nesta amostra, quatro linhas de texto viram setenta e duas linhas de etiquetas, e a numeração da lista mora em outro arquivo.
.docx guarda por dentro e o que o Markdown guarda.
A descrição original tinha ambiguidades, e por anos o mesmo texto aparecia de um jeito num sistema e de outro jeito no seguinte. A resposta foi uma especificação formal, o CommonMark, mantida por John MacFarlane, que define o Markdown como “um formato de texto puro para escrever documentos estruturados, baseado nas convenções para indicar formatação em e-mails e mensagens de fóruns” (MacFarlane, 2024). É essa definição que vale hoje, e é dela que partem os dialetos que você vai encontrar, inclusive o que o Quarto entende. A lista completa das marcas está no capitulo Capítulo 6.
2.5 Dois modelos de trabalho
O sociólogo Kieran Healy, num guia escrito para estudantes de pós-graduação, descreve que há soluções “tipo Office” e soluções “tipo engenharia”. Nas primeiras, “um arquivo do Word, ou um conjunto deles, é a coisa mais ‘real’ do seu projeto. As mudanças no seu trabalho são registradas dentro desse arquivo”; os gerenciadores de referência se encaixam nele; as tabelas e figuras são coladas nele. Nas segundas, “arquivos de texto puro estão no centro do seu trabalho”, as mudanças são registradas fora deles, por um sistema de controle de versões, e “os resultados finais são montados a partir do texto puro e transformados em PDF, página da web ou Word por alguma ferramenta de conversão” (Healy, 2020, p. 5).
Healy é o primeiro a admitir que o modelo Office domina as humanidades e as ciências sociais, e que “há pouco a ganhar com o dogmatismo do texto puro num mundo de .docx” (Healy, 2020, p. 6). A razão para preferir o segundo modelo não é pureza; é controle. Quem escreve em texto puro pode gerar o .docx quando alguém o exige, e continua dono da fonte.
2.6 Um formato e um estado de espírito
Dennis Tenen, que é ao mesmo tempo professor de literatura e programador, dá ao texto puro uma definição que fecha este capítulo. “Texto puro identifica um formato de arquivo e um estado de espírito. Como formato de arquivo, contém nada além de uma ‘sequência pura de códigos de caracteres’”, em oposição ao “texto elaborado”, que é “texto puro mais informação adicionada” (Tenen, 2017, p. 3). E ele aponta o que está em jogo: “além do conteúdo visível, todos os documentos contemporâneos carregam consigo uma camada de informação oculta” (Tenen, 2017, p. 3).
Essa camada oculta é exatamente o que o mouse esconde, e a Figura 2.2 a mostra num caso em que ela pesa mais: uma imagem e uma tabela. Dentro do .docx, a imagem vira um arquivo escondido no pacote, renomeado com um código, e a tabela vira outra pilha de etiquetas. No Markdown, a imagem é um endereço, o nome do arquivo na pasta do projeto, e a tabela são linhas com barras verticais. Trocar a figura é trocar o arquivo na pasta; ninguém precisa abrir nada.
.docx, a imagem é um arquivo escondido referido por um código; no Markdown, é um endereço.
O Bravo e seus descendentes criaram essa camada e a mantiveram invisível; o Scribe, o LaTeX e o Markdown a puseram à vista, em texto que qualquer pessoa lê e qualquer programa entende. Que essa última qualidade, “qualquer programa entende”, incluísse um dia os programas que escrevem, ninguém previu em 2004. É o assunto de Capítulo 3.
- Duas ideias nasceram nos anos 1970: o editor que mostra a página como ela sairá impressa (Bravo, depois Word) e a marcação lógica, que diz o que cada trecho é e deixa a aparência para um sistema (Scribe, depois LaTeX e as páginas da web).
- O WYSIWYG guarda a aparência e perde o significado: “o que você vê é tudo o que você tem”. Serve para cartas; falha em documentos longos.
- A marcação lógica separa forma e conteúdo: a aparência de todos os títulos vive num só lugar, e o autor volta a se ocupar do texto.
- O Markdown, de 2004, é a marcação lógica com a legibilidade do e-mail: publicável como está, em texto puro.
- Texto puro é um formato e um estado de espírito: nada de camada oculta. Preferi-lo não é dogma, é controle sobre a própria fonte.