Markdown vs. ReStructuredText for Teaching Materials

moistly 2021-08-16 23:07:29 +0000 UTC [ - ]

AsciiDoctor is also well worth investigating; it is designed to compile to Docbook XML, which has a rich set of publishing tools.

type0 2021-08-19 00:37:34 +0000 UTC [ - ]

One of those tools is dblatex https://pypi.org/project/dblatex/

Going from asciidoc to docbook to LaTeX to pdf while sounds complicated is actually quite simple in practice.

tconfrey 2021-08-16 21:56:34 +0000 UTC [ - ]

What about org-mode? See this treatise: https://karl-voit.at/2017/09/23/orgmode-as-markup-only/

I hadn't heard of ReStructuredText!

Madeindjs 2021-08-17 21:00:41 +0000 UTC [ - ]

You totally miss point of this article: Markdown, even if not so powerful, have many more tools and support than other markup language (including org-mode)