MkDocs

[Livid]

http://www.mkdocs.org/

可以用 Markdown 写的文档站。

[Livid]

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

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

[kxxoling]

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

[Livid]

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

[kxxoling]

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

[glasslion]

MkDocs 不支持搜索 ，硬伤

[bcxx]

功能有点少啊…… 不好用

[limbo0]

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

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

[lepture]

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

[yuankui]

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

[luw2007]

已经用上，+1

[abbatuu]

@yuankui mdwiki

[workwonder]

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

[workwonder]

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

[lepture]

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