Por que o Markdown dominou o mundo

• Um formato baseado em texto simples se consolidou como a linguagem comum da indústria global de tecnologia e é amplamente usado, de sistemas de IA a apps de anotações do dia a dia
• Criado em 2004 por John Gruber para resolver o incômodo da edição em blogs, o formato permitiu que qualquer pessoa escrevesse documentos para a web com facilidade
• Oferecendo sintaxe intuitiva e estrutura aberta tanto para desenvolvedores quanto para usuários comuns, foi integrado a quase todas as plataformas, como GitHub, Slack e Apple Notes
• Feito com um espírito de compartilhamento e colaboração, mais do que por lucro comercial, mostra a sustentabilidade do ecossistema de tecnologia aberta
• Hoje, é um formato tão fundamental para a internet que até os sistemas centrais de controle da indústria de IA são escritos em Markdown

---

A origem e a expansão do Markdown

• O Markdown é uma linguagem de formatação concisa criada no início dos anos 2000 para resolver o problema da edição complexa em HTML nas ferramentas de blog
  • John Gruber administrava desde 2002 o blog centrado no ecossistema Apple Daring Fireball e desenvolveu a solução para aliviar o desconforto na hora de escrever textos
  • Na época, blogueiros precisavam escrever HTML manualmente para inserir links ou texto em negrito
• Em 2004, Gruber realizou testes beta com Aaron Swartz para lapidar o formato e o lançou em março
  • O feedback de Swartz contribuiu para aumentar a estabilidade e a flexibilidade
• Logo após o lançamento, ele se espalhou para além dos blogs e passou a ser usado para diversas finalidades, evoluindo de uma ferramenta pessoal simples para um formato padrão da web como um todo

Princípios e características do Markdown

• Uma estrutura de sintaxe intuitiva que permite representar formatação web usando apenas caracteres comuns do teclado
  • Ex.: [texto do link](URL) ou # título
• Como o próprio nome “Markdown” indica, reduzindo a complexidade de “Markup”, seus valores centrais são a simplicidade e a legibilidade
• É fácil o bastante para qualquer pessoa aprender em poucos minutos e, ao mesmo tempo, oferece forte poder de expressão
• Sua implementação técnica é simples, o que fez com que a maioria das ferramentas de blog e aplicativos passasse a suportá-lo rapidamente

Expansão por toda a indústria

• Ao longo de décadas, o Markdown se firmou como a linguagem básica da indústria de software
  • Apps importantes como Google Docs (2022), Microsoft Notepad e Apple Notes adicionaram suporte
  • Também é usado em plataformas de mensagens como Slack, WhatsApp e Discord
• Quase todo repositório no GitHub inclui arquivos em Markdown, usados como padrão para descrição de projetos e documentação
• Existem bilhões de arquivos Markdown em discos rígidos e na nuvem ao redor do mundo
  • Inclusive em sistemas embarcados como consoles de videogame e fones de ouvido

O espírito de tecnologia aberta e colaboração

• O Markdown foi publicado gratuitamente, sem fins comerciais, permitindo uso livre por qualquer pessoa
  • Gruber não exigiu compensação financeira pelo formato
• No contexto da cultura da web aberta do início dos anos 2000, tornou-se um caso representativo do modelo colaborativo de desenvolvimento, em que padrões são compartilhados e aprimorados
• Graças a essa abertura, não surgiu uma alternativa fechada dominante, e ele se estabeleceu como infraestrutura pública da internet

Markdown na era da IA

• Hoje, a maior parte dos prompts e scripts de controle de modelos de linguagem de grande porte (LLMs) é escrita em formato Markdown
  • Instruções avançadas de trabalho em ChatGPT ou Claude também se baseiam em Markdown
• Um formato de texto simples evoluiu para a linguagem central de controle da indústria de IA
• Esse formato gratuito criado por Gruber está sustentando a indústria de IA de trilhões de dólares
• Na base do avanço tecnológico não estão apenas as gigantes do setor, mas também contribuições individuais feitas com paixão e cuidado

10 motivos técnicos para o sucesso do Markdown

• 1. Um nome excelente: intuitivo e fácil de lembrar, como contraponto a “Markup”
• 2. Resolveu um problema real: eliminou o incômodo de escrever HTML complexo
• 3. Baseado em hábitos de uso familiares: aproveitou símbolos já usados em e-mails e outros contextos
• 4. Estrutura aberta de evolução, semelhante ao RSS: cresceu junto com a cultura dos blogs
• 5. Comunidade colaborativa: com tecnologias anteriores como Textile, de Dean Allen, e a participação de Swartz
• 6. Suporte a várias variações: extensões como CommonMark e GitHub-Flavored para diferentes contextos
• 7. Captou o momento de mudança no comportamento dos usuários: surgiu na expansão dos blogs e das redes sociais
• 8. Boa combinação com a era das build tools: o processo de conversão para HTML se encaixa bem em fluxos de trabalho automatizados
• 9. Manteve a filosofia de ‘View Source’: qualquer pessoa pode ver a fonte original e aprender
• 10. Sem restrições de propriedade intelectual: adoção livre por não haver patentes nem limitações de licença

Conclusão

• O Markdown se tornou a linguagem básica da internet por sua simplicidade, abertura e design centrado no ser humano
• Prova que a criatividade individual e o espírito de colaboração, e não apenas o grande capital, podem impulsionar a inovação tecnológica
• Ainda hoje, no núcleo da IA e da web, sua base continua sendo um formato de arquivo de texto criado por um único desenvolvedor

[GN⁺]

Comentários do Hacker News

• O texto foi muito bem escrito. Mas o principal motivo de eu gostar de Markdown é que ele é fundamentalmente baseado em texto
  Não tem dependência de formato nem de fornecedor, e é perfeito para colocar em um repositório git. Não preciso me preocupar se um formato como o do OneNote ainda vai abrir em 2035
  Também gosto do fato de que os LLMs entendem Markdown por padrão. Se eu pedir no código do servidor para gerar documentação de API, ele entende imediatamente que eu quero um resumo baseado em texto

  • Markdown basicamente formalizou as convenções que as pessoas já usavam em arquivos de texto. Eu também costumava escrever documentos em texto puro e depois percebi que já estava usando sintaxe Markdown. Aí bastava mudar a extensão para .md e fazer uns pequenos ajustes para ficar bonito
  • Claro que existem formatos melhores, como AsciiDoc ou reStructuredText. Mas, no fim, há muitos lugares em que você precisa usar Markdown, então ele continua sendo uma opção boa o bastante
  • Markdown é, essencialmente, texto mais ou menos legível. É por isso que ele não suporta tabelas. Por melhor que seja a sintaxe, é difícil representar tabelas bonitas em texto puro
  • Eu também passei a preferir texto pelo mesmo motivo. Estou lendo The UNIX Programming Environment (1984) agora, e esse livro está me fazendo sentir de novo a durabilidade dos formatos baseados em texto
  • É por isso que gosto do Obsidian. Ele parece um sistema operacional para Markdown

• No passado, adicionei suporte a Markdown ao Google Docs como um projeto 20%. É uma honra ter meu nome mencionado na história do Markdown

  • Esse recurso deixou o Google Docs muito mais agradável. Especialmente junto com o atalho alt+/, fica muito prático
  • Ajuda bastante na hora de criar e compartilhar documentos rapidamente
  • Uso quase todos os dias. Obrigado!

• Não é tanto que escrever HTML diretamente seja difícil; o charme do Markdown é que o próprio texto-fonte é fácil de ler
  E apresento meu editor Kraa, no qual é possível personalizar a “aparência” do Markdown

  • Eu já tinha visto o Kraa antes, mas ao testar de novo achei a quebra de linha entre palavras estranha, o fato de esconder # dificulta mudar o estilo dos cabeçalhos, e ele usa uma sintaxe não padrão para checkbox ([]), o que foi incômodo. A interface é bonita, mas como editor de Markdown deixa a desejar
  • O produto parece bom, mas não permite self-hosting, então a segurança não é clara. Para notas pessoais tudo bem, mas para uso no trabalho dá insegurança. Também fico curioso se existe um plano de monetização
  • Há casos em que <br> é necessário. Por exemplo, em células de tabela com múltiplas linhas, onde também precisa ser usado com fonte monoespaçada
  • Se você desativa JavaScript, só aparece uma tela em branco. Isso é meio decepcionante

• Eu realmente gosto de Markdown. Ainda assim, me surpreende que a maioria dos navegadores ainda não consiga abrir arquivos .md diretamente. Seria bom se o navegador convertesse automaticamente para HTML e exibisse

  • Eu uso Markdeep. Adiciono um snippet de código ao fim do documento e salvo como .md.html, e ele renderiza direto no navegador. Deixo no Google Drive e isso substitui todos os meus apps de notas
  • Para implementar isso, seria preciso uma padronização do Markdown. Existe o CommonMark, mas ele ainda é complexo e ambíguo
  • É estranho que quase não existam apps leitores para simplesmente renderizar Markdown de forma bonita. Não entendo por que algo tão simples não existe
  • Seria legal se o navegador pudesse renderizar com um botão tipo “ver como HTML”; fico curioso para saber por que isso foi rejeitado
  • Também é uma pena não existir uma API JS padrão para converter Markdown em HTML seguro

• No texto faltou a história de Jeff Atwood (fundador do Stack Overflow) ter sugerido ao Gruber a padronização do Markdown
  Gruber acabou recusando, mas acho que o fato de ele insistir no que queria fazer é um exemplo inspirador

  • Na prática, foi o Atwood quem primeiro publicou o documento “Standard Markdown”, e Gruber não aprovou isso. Depois o nome do projeto mudou para CommonMark. No fim, isso ajudou a preservar a simplicidade
  • Mas a falta de um padrão me trouxe problemas de compatibilidade várias vezes

• A expressão “tem um sabor para cada contexto” é engraçada. Como Markdown não é unificado, bold e bold, ou italics, acabam confundindo
  Mesmo assim, eu gostaria que o CommonMark fosse mais amplamente adotado

  • Acho que notações mais intuitivas, como /italics/ e _underline_, seriam melhores, como em outros formatos
  • Na prática, a distinção entre negrito e itálico não é tão importante. Basta transmitir a ênfase
  • Antes eu odiava essas variações, mas agora aceito isso como “Practical Postelism”. Em vez de um padrão perfeito, essa diversidade prática ajuda no sucesso do sistema
  • A notação de negrito com asterisco único no Slack não é Markdown. É tão incômodo que eu simplesmente decorei o atalho de teclado

• Existe um novo formato chamado Djot(djot.net), criado pelos autores do CommonMark e do Pandoc. Ele é mais razoável e mais fácil de fazer parse

  • Mas, para usuários coreanos, a pronúncia de “djot” soa como um palavrão
  • A especificação não é clara, então é difícil criar uma nova implementação
  • Ainda assim, ele parece um Markdown mais rígido e limpo, então pretendo experimentar
  • Eu uso Djot no meu projeto (cliente Moor). Ele é seguro, familiar e fácil de fazer parse

• As vantagens do Markdown são claras
  Baseado em texto, amigável para git, amigável para LLMs e com excelente capacidade de busca
  Mas layouts complexos, tipografia precisa e embutir binários são impossíveis. Fico curioso sobre que outras limitações ele tem

  • Quando listas em vários níveis ficam profundas demais, elas acabam sendo renderizadas como blocos de código. Isso é uma grande desvantagem do Markdown
  • O CommonMark funciona como um superconjunto de HTML. Mas há muitas diferenças sutis entre implementações
  • Markdown é bom para anotações simples, mas inadequado para documentos estruturados. Isso porque não tem marcação semântica
  • Faltam formas de expressão acadêmica, como fórmulas, distinção entre minúsculas e maiúsculas e seções de documento
  • Em sintaxes estendidas, dá para colocar HTML/CSS ou imagens em base64, mas isso já foge do espírito do Markdown

• O motivo de o Markdown ter vencido foi o timing
  AsciiDoc, org-mode e outros são mais estruturados, mas não tiveram popularidade.
  Quando o GitHub escolheu Markdown, toda a comunidade open source acabou seguindo naturalmente.
  Como na disputa entre VHS e Betamax, não foi a melhor tecnologia que venceu, e sim o formato que se estabeleceu primeiro

• A descrição “uma pessoa rabugenta, mas calorosa, que provavelmente agora estaria vendo um filme do Kubrick e torcendo por um time sem pé nem cabeça” foi marcante