Comment by dochtman

Start here:

http://sphinx-doc.org/rest.html

Then go here for more:

http://docutils.sourceforge.net/docs/user/rst/quickref.html

I don't really understand why reST is so unpopular compared to Markdown.