DEV Community

Discussion on: 5 Best Free Note Taking Apps for Programmers

Collapse
 
jmfayard profile image
Jean-Michel πŸ•΅πŸ»β€β™‚οΈ Fayard • Edited

Well everyone has a different Markdown.
GitHub has its extensions, some of which makes sense for everyone, others only on GitHub.
Dev.to has liquid tags. They are great but again not part of a standard format.
Static website generators have a yaml front end matter. Why not?
What if you want a table of contents? Just add another external tool.
What if you want to use variables? Nope.
What if you want to structure your work by including another file, or a part of another file? Nope.
The syntax for inserting an image is mostly worse than plain HTML.
Ever tried to maintain a table in markdown? That sucks as lot.

Common Markdown tried to find a common ground, the Markdown Creator was not happy about it, but also it turns out it's not possible.
Everyone use a different Markdown plus something.

Asciidoc is my Markdown++
See here and the comparaison with markdown

asciidoctor.org/docs/user-manual/#...

Thread Thread
 
albertomontalesi profile image
AlbertoM

Oh yeah, I agree with your points. I'll give asciidoc a try, thanks.

Thread Thread
 
jmfayard profile image
Jean-Michel πŸ•΅πŸ»β€β™‚οΈ Fayard

The key is to find a converter Markdown to Asciidoc, to start with what you already know. I am doing this in IntelliJ idea but there is probably a lighter alternative πŸ˜ƒ
Pandoc comes to mind.