Sphinx should support Markdown, we're using the instructions at https://www.sphinx-doc.org/en/master/usage/markdown.html https://www.sphinx-doc.org/en/master/us

Sphinx should support Markdown, we're using the instructions at https://www.sphinx-doc.org/en/master/usage/markdown.html https://www.sphinx-doc.org/en/master/usage/markdown.html for our project and haven't had any issues. Haven't tried it yet but you should also be able to enable rst blocks through recommonmark so you get the best of both - https://recommonmark.readthedocs.io/en/latest/auto_structify.html#embed-restructuredtext https://recommonmark.readthedocs.io/en/latest/auto_structify...