3 ms·

3 reasons (for me)... all of this are harder to write and to remember in restructured text: source code blocks, links and images. Also sections definition is to

• mineo 11y ago
  I agree on the section definitions. It's very hard to remember which underline I need to use because every project (or even document) can just define their own order implicitly. The sphinx project recommends a specific order somewhere in their documentation that I look up every time I need to write rst, but markdowns just-count-the-hashes is much easier.
• dalai 11y ago
  I personally prefer Asciidoc(tor). The syntax for the basic stuff (headings, source code, links) is at least as easy as for markdown, but it also allows more advanced cases (tables, splitting into files, text substitutions, etc.) without resorting to writing html or using external tools. Asciidoctor also directly supports the markdown style for headings, block quotes, etc. I see markdown more for writing a quick note or something that will not exceed a few pages.