from recommonmark.parser import CommonMarkParser source_parsers = {'.md': CommonMarkParser} source_suffix = ['.rst', '.md'] This allows you to write both .md and .rst files inside of the same project. Example Project¶ You can see this in action in my sphinx-markdown-test repo on GitHub. You can also see a rendered version hosted on Read the Docs. How it works¶ The way this project works is that it
![Read the Docs & Sphinx now support Commonmark](https://cdn-ak-scissors.b.st-hatena.com/image/square/32b5a352b1dbcec30c94a6971d368b1b4f305e55/height=288;version=1;width=512/https%3A%2F%2Fblog.readthedocs.com%2F_static%2Flogo-opengraph.png)