In the latest version of Logic for Programmers, the author introduces an alternative markup language called reStructured Text (rST) used in Sphinx. The author explains how rST differs from markdown and highlights its advantages, such as a more complex but powerful syntax that allows for extending functionality through various directives. The author also discusses a custom exercise extension created for the book, showcasing the flexibility and customization capabilities of Sphinx. Despite some criticisms of rST’s syntax, the author advocates for exploring different document builders to find the best tool for individual needs. The reader is encouraged to consider the potential of more sophisticated documentation generators beyond simple markdown.
https://buttondown.email/hillelwayne/archive/why-i-prefer-rst-to-markdown/