On: Don't write documentation in Markdown

[glofish]

I tried reStructuredText and I found that writing hyperlinks was very tedious and ugly. Here is the example from the tutorial

  External hyperlinks, like `Python <http://www.python.org/>`_.

Look at how many special characters it needs and how interferes with reading.

I found it annoying and tiring to write and to read. It is the main reason I went with Markdown.

RST may be superior technology-wise but it inferior when it comes to usability

[fcurts → glofish]

I had the same gripes with RST. Then I found Asciidoc(tor) and never looked back. Asciidoc is as easy to learn and use as Markdown and more powerful than RST. Best combined with Antora, Asciidoc's answer to Sphinx.