Why reStructuredText and not markdown (2016)

• https://www.ericholscher.com/blog/2016/oct/6/authoring-documentation-with-semantic-meaning/ (2016)

• https://www.ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/ (2016)

Adam Chainz

• https://fediverse.org/AdamChainz/status/1435567530303803392?s=20

• https://www.ericholscher.com/blog/2016/oct/6/authoring-documentation-with-semantic-meaning/

rst is a semantic format whilst markdown is a non-extensible html superset

This is why Sphinx is so good for writing documentation, books, etc.

I can write once in a single format and export to HTML, PDF, ePub, Kindle..