One issue with Markdown is that there's many flavors with subtle differences in parsing/interpretation. If you're looking to be able to parse the file in the fu

One issue with Markdown is that there's many flavors with subtle differences in parsing/interpretation. If you're looking to be able to parse the file in the future, you have to be careful to pick a flavor with wide support or to stick to the most common features of Markdown.