Markdown格式设置

Sphinx原生不支持Markdown，但是稍作调整就可以正常使用。

Markdown capable Sphinx #825

Please try:

pip install commonmark recommonmark
conf.py

source_parsers = {
    '.md': 'recommonmark.parser.CommonMarkParser',
}
source_suffix = ['.rst', '.md']
It's still limited, but usable.

使用sphinx结合markdown写项目文档