Markdown配置
sphinx支持markdown，使用的是CommonMark语法
配置
需要安装recommonmark
$ pip install --upgrade recommonmark
然后在配置文件conf.py中添加Markdown解析器
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = ['recommonmark']
增加'.md'作为扩展名
source_suffix = {
'.rst': 'restructuredtext',
'.txt': 'markdown',
'.md': 'markdown',
}