无论是markdown还是reST, 在github上都能得到不错的支持.
readthedocs是一个sphinx文档托管站点. 支持从git, github, svn导入项目 以下以github为例, 讲述文档的托管
注册readthedocs账号
在readthedocs中新建项目
新建项目 手动导入 填写项目名称和地址
github中启用webhook, 通知readthedocs自动构建