Why You Shouldn’t Use “Markdown” for Documentation¶ “Markdown” is the most commonly used lightweight markup language on the internet. It is great for a subset of tasks, mainly blog posts and commenting. However, lately it has been adopted by the technical writing community as a solution for writing documentation. I’d like to lay out the main arguments that I have against Markdown. Hopefully this w