Por que prefiro reStructuredText a Markdown

Este artigo explica por que o autor prefere reStructuredText (rST) a Markdown para escrever livros técnicos. O rST, sendo uma representação de peso médio de uma árvore de documentação abstrata, oferece extensibilidade e personalização superiores em comparação com a abordagem leve do Markdown. O autor ilustra isso com exemplos de criação de imagens e tratamento de exercícios, mostrando como as diretivas personalizadas e as transformações de árvore de documentos do rST permitem estruturas de documentos complexas e funcionalidades difíceis de alcançar no Markdown. Embora reconheça a sintaxe potencialmente menos intuitiva do rST, o autor defende sua potência para documentação em larga escala, especialmente quando são necessárias extensões e transformações personalizadas, como demonstrado em seu livro, "Lógica para Programadores."
Leia mais