Writing Markdown in Sphinx
==========================

While Sphinx natively supports using `ReStructured Text <https://docutils.sourceforge.io/rst.html>`_ for generating HTML
files, Markdown (which was used in the past) is also supported via the `recommonmark
<https://github.com/readthedocs/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.