Virtues when writing comments on HN, blog posts, READMEs or whatever. When you are writing non-trivial, lengthy technical documentation, at some point you may n

Virtues when writing comments on HN, blog posts, READMEs or whatever. When you are writing non-trivial, lengthy technical documentation, at some point you may need markup for examples, notes, tables, figures, cross-references, function parameters, class methods, etc. Sure you could still do something like that with basic markdown, but you would need to write down all your conventions somewhere if you are not working alone. At that point you could just use whatever comes with those conventions baked-in.