Render output from markdown file inside .rst file

Question

I am using Sphinx for documenting a Python project and would like to have content from an existing .md file display inside of a .rst f

Answer 1

Try M2R sphinx extension.

https://github.com/miyakogi/m2r#sphinx-integration

After install m2r and change conf.py, just change .. include to .. mdinclude would work well.

ml
==

Tutorial
--------
.. mdinclude:: ../tutorial.md

w2v
^^^

.. automodule:: package.ml.w2v
:members: