[imron]

> RestructuredText has generally worked nicer for me that Markdown

Agree. As soon as you want to start having references to other parts of your document(s) RestructuredText wins out over Markdown.