I had to write documentation recently and it needed to be written in AsciiDoc. I can't tell how delightful it was to use compared to simple Markdown. Stuff like code block, unordered lists indentation were particularly better thought out in my opinion.