Comparison of Common markup for Markdown and reStructuredText · GitHub
Posted by jpluimers on 2017/10/09
This is a very good comparison of how to use reStructuredText and Markdown well for rendering at GitHub: [WayBack] Common markup for Markdown and reStructuredText · GitHub.
It is being updated by Alex Dupuy over time at https://gist.github.com/dupuy/1855764 and has two sections:
And it refers to http://pandoc.org/try/ which I had missed when starting with reStructuredText a long time ago.
Examples in there are actually more useful to me than these reStructuredText ones:
- http://docutils.sourceforge.net/docs/user/rst/quickstart.txt – A ReStructuredText Primer
- You can view it rendered
- http://docutils.sourceforge.net/rst.html – reStructuredText Markup Syntax and Parser Component of Docutils
- http://docutils.sourceforge.net/docs/user/rst/quickref.html – Quick reStructuredText
–jeroen
jpluimers said
Via https://plus.google.com/+JeroenPluimers/posts/jntKj4Ng6BJ by Joseph Mitzen:
You can also use ReST for document generation via Sphinx and Markdown and ReST for blog generation via many static website generators, such as Nikola:
rvelthuis said
Dunno. I tried both, but like Textile a lot more than Markdown or reStructuredText. It is much more powerful.