Hacker News Reader

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 totally fuzzy for me http://docutils.sourceforge.net/docs/ref/rst/restructuredtex...

Markdown can work more like your mind. Restructured text is still too much like programming.

View on HN

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.

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.

Reply on news.ycombinator.com