MkDocs

而且现在 Read The Docs 也支持导入用 MkDocs 写的项目了：

http://docs.readthedocs.org/en/latest/getting_started.html

感觉 Markdown＋YAML 写起来简单些。

@kxxoling RST 的标题下面的 === 要和标题长度一样的设定很讨厌，因为中文的宽度。

@Livid 其实是不必要的，构建的时候把 -W 参数改为 -w 就不那么严格了。如果没记错的话， ==== 只要是 4 个或以上就可以了。
不过 Sphinx 的语法太多了（虽然也更强大），不像 md 的一级标题、二级标题……可以直接写成 n 个 # 。

MkDocs 不支持搜索 ，硬伤

功能有点少啊…… 不好用

最近也在用mkdocs,功能比较简单实用.

但是有一点不太好,就是文档一般都写在一个文件里,mkdocs的思想是分开写~~

没有 ref 的功能就不要自称文档生成了

@lepture
@glasslion
有推荐的吗?类似的

已经用上，+1

@yuankui mdwiki

@lepture 的 [nicojs](https://github.com/aralejs/nico-arale/) 不错，但是不够活跃，用起来有点孤单。

地址发错了，是： https://github.com/lepture/nico

@workwonder 這個是在 Alipay 時爲前端小組設計的，裏面有很多爲寫 JavaScript 文檔的 trick。如果不是做前端開發，不建議使用。這個目前主要是 arale 團隊與支付寶前端團隊在用，有一個騰訊的團隊也在用。