One of the most salient features of our Tech Hiring culture is that there is so much bullshit. Everyone knows this. Each of us contributes his share. But we tend to take the situation for granted.
I'm replacing Markdown by Asciidoc.
Markdown is broken, it's sad
It has all the right ideas to start with, so everybody starts with it, and then everybody notices it's not enough and do its proprietary extension of Markdown.
There are so many Markdown to choose from that after getting once too much in that rabbit hole, I decided to switch to Asciidoc.
Asciidoc is basically markdown done right.
One of the most salient features of our Tech Hiring culture is that there is so much bullshit. Everyone knows this. Each of us contributes his share. But we tend to take the situation for granted.
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
One of the most salient features of our Tech Hiring culture is that there is so much bullshit. Everyone knows this. Each of us contributes his share. But we tend to take the situation for granted.
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.
For further actions, you may consider blocking this person and/or reporting abuse
We're a place where coders share, stay up-to-date and grow their careers.
I'm replacing Markdown by Asciidoc.
Markdown is broken, it's sad
It has all the right ideas to start with, so everybody starts with it, and then everybody notices it's not enough and do its proprietary extension of Markdown.
There are so many Markdown to choose from that after getting once too much in that rabbit hole, I decided to switch to Asciidoc.
Asciidoc is basically markdown done right.
I never used it, could you elaborate more on daily use cases where you found markdown to not be enough/be broken?
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/#...
Oh yeah, I agree with your points. I'll give asciidoc a try, thanks.
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.