Do not get me wrong Markdown is a great way to format text and write articles.
But if you go deeper, you will find its limitations.
For documentation and knowledge management you will miss some basic features that are very obvious like footnotes and info boxes or even variables, snippets (text blocks) and including other documents or graphs.
Even extensions like Git Flavored Markdown are a first step but are not visibly moving further.
Commonmark tries to create a base for extending markdown but as far as I read it is kind of stuck.
There is a standard called ascidoc, that was adopted by the ruby community and enhanced as the asciidoctor standard. If you use a non mobile operating system (OS) you will able to set up a ruby based or nodeJS based workflow to get all these and more features inside your markup text document.
I looked into it and fell in love with it.
why do I put it here?
Because Drafts soon will be able to define own syntax highlighting capabilities for the users and I hope to stirr up some fellow users that would like to use asciidoc inside drafts.
A small side note: asciidoctor adds the basic markdown syntax to its specification so that you can easily use your already written markdown inside its eco system.
So look at it and report back on this thread if it is to your liking or if you think I am wrong…