3 ms·
As far as I can tell the only advantage rST has over markdown is that it's better defined. I rarely find that I prefer the rST syntax to markdown.
by aidenn0 12y ago
As far as I can tell the only advantage rST has over markdown is that it's better defined. I rarely find that I prefer the rST syntax to markdown.
- buster 12y agoI frequently write documentation with sphinx, over 30 pages long. rST is a blessing for me. Markdown doesn't even get near. It's fine for some 20 line README on github but that's about it.
- aidenn0 12y agoI'm with you there in that I couldn't imagine writing 30 pages of markdown. For something like extensive documentation, I could imagine rST winning, particularly since there is a standard syntax for extending it. I still mostly use LaTeX for documentation though.
- buster 12y agoYou should give sphinx + latex a try. I have my own cookiecutter template for docs and it's never been easier and fast to write some good looking documents.