myst-parser

myst-parser is a Markdown parser (.md files) that allows you to combine all the power of Markdown with all the potential of Sphinx. All at once!

Note

This whole page is written in Markdown (see Show Source).

As you can see, Sphinx extensions keep working without changes (e.g. sphinx-prompt and sphinx-copybutton)

Installation

pip install myst-parser

Configuration

# conf.py
extesions = [
    '...',
    'myst_parser',
]