To me, one of the big features of markdown is it's half WYSIWYG.
By that I mean, the basics reuse the way we faked formatting to do real formatting. The input is (usually) perfectly readable on its own.
Even if you don't know (or remember) how to author a markdown file, you can probably still read it just fine. The tables still look like tables. The paragraphs are just paragraphs.
I do still have to look up how to do stuff in markdown sometimes. And that's fine. Your active vocabulary is always smaller than your passive one.
So the way I judge this is by how readable the input is.
I'm not sure how well they succeeded at that. A lot of what they show doesn't really add to or take away from that.
But I didn't see any examples of them formatting math. I only rarely use LaTex. And when I do, it's not because I need a "paged" mode or need to include an author. It's because I need to format something markdown can't do, and that's usually a math equation.
So I am curious how that ends up looking.
That’s exactly why I built Quarkdown. Flat learning curve for basic formatting, powerful customizations for the rest. Spot on!
I think that's an interesting idea, but you hit the landing page and there's loads of syntax thrown in your face and you're like, man, I need to learn a lot.
But I think this kind of brings up another problem, which is that you can choose not to use stuff if you're writing, but if you're reading other people's docs or editing them, then you need to know all the syntax they use. Most OSS projects with markdown docs today, anyone can open an MR to improve them.