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





