Writing Markdown in Sphinx

While Sphinx natively supports using ReStructured Text for generating HTML files, Markdown (which was used in the past) is also supported via the recommonmark plugin.

Note that not all features of flavored markdown is supported. When editing a markdown document, ensure that Sphinx can still compile the file into an HTML file with no warnings.