MkDocs vs Sphinx
之前整理了一套文档生成、托管和发布流程，使用Sphinx完成工程文档的生成，使用Github完成文档的托管，使用Readthedocs完成文档的发布
在实践过程中发现整个流程都有或大或小的不足，尤其是Sphinx工具，最近学习了另外一个文档生成工具MkDocs，更加符合个人的需求
Sphinx问题
Sphinx是一个文档生成工具，提供了方便快捷的文档生成操作，默认支持reStructuredText
虽然也能够使用Markdown，但是在实际操作过程中，发现若干问题：
- 不能有效设置数学公式渲染
- 不支持
Markdown表格
MkDocs解析
MkDocs同样是一个简单、易用的文档生成工具，其默认支持Markdown，能够使用表格语法，同时通过扩展能够解决数学公式渲染的问题
同时相比于Sphinx，其配置更加简洁易懂，降低使用门槛
小结
替换掉Sphinx，当前的文档操作流程是
mkdocs文档制作，github远程托管，readthedocs在线发布
实现教程：ZJDoc/DocGuide