3 ms·
While I agree with most of what is said in this article, Markdown still has ubiquity. And while MD doesn't have an official standard, you still have a standard
by liamkinne 8y ago
While I agree with most of what is said in this article, Markdown still has ubiquity.
And while MD doesn't have an official standard, you still have a standard, it's just defined by whatever is rendering your MD. E.g. GitHub markdown has well documented behaviour.
- guitarbill 8y agoIn late 2018, GitHub-flavoured Markdown (GFM) has basically won, and is in tools used every day. reStructuredText has always had a learning curve, but is even more painful if you're used to using Markdown (`foo` in MD vs ``foo`` in reST). I do use reStructuredText/Sphinx for Python, but it's a chore onboarding new developers, to the point where I may not bother in future. Getting developers to write docs is the most important - badly formatted Markdown is still better than no docs. Lower barrier to entry wins. Eric does understand this very well via Read the Docs/Write the Docs (which are awesome), but reStructuredText's weirdness will always be an issue.