# Markdown格式设置

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

[Markdown capable Sphinx #825](https://github.com/sphinx-doc/sphinx/issues/825#issuecomment-180197293)

````
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写项目文档](http://blog.hszofficial.site/blog/2016/11/29/%E4%BD%BF%E7%94%A8sphinx%E7%BB%93%E5%90%88markdown%E5%86%99%E9%A1%B9%E7%9B%AE%E6%96%87%E6%A1%A3/)