使用Markdown

Markdown是比restructuredText更加轻量的标记语言。Sphinx支持用Markdown进行写作。

启用Markdown需要如下步骤：

1. 安装recommonmark：:

   pip install recommonmark
   

2. 添加如下内容到conf.py中：:

   source_parsers = {
   '.md': 'recommonmark.parser.CommonMarkParser',
   }
   

3. 添加Markdown的文件扩展名到配置文件的source_suffix变量：:

   source_suffix = ['.rst', '.md']