23 ms·
This article is great. I really never understood the preference of Markdown over rST. Also, little do people know that github supports rst https://github.com/gi
by buster 12y ago
This article is great. I really never understood the preference of Markdown over rST.
Also, little do people know that github supports rst https://github.com/github/markup https://github.com/github/markup
But looks like Creole as well, which i didn't know :)
- aidenn0 12y agoAs 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.