有没有好的 api 文档管理系统？

[subpo]

需求如下：
1.可部署成web页面
2.可用markdown书写api文档
3.有后台，可以直接在网站上添加api

[Livid]

https://dash.readme.io/

可以做出很像 Stripe 文档网站的 API 文档站。

[aveline]

http://apiary.io/
http://apidoc.io/

不需要后台的话，试试这个 http://tripit.github.io/slate/

[xw]

关注

[subpo]

我希望是面向内部使用的，多项目的api文档，而不是一个项目介绍文档

[subpo]

@aveline
@Livid
我希望是面向内部使用的，多项目的api文档，而不是一个项目介绍文档，最好是能部署到自己服务器上的开源的项目（毕竟不想让别人看到私有的api文档），要求好像挺苛刻的，有吗...

[harryert]

mark，我也想知道。。。

[lululau]

Github Enterprise

[subpo]

@aveline http://apidoc.io/ 很符合我的需求，要是这个网站能支持只有固定的登录用户才能看到文档就好了...

[efi]

Markdown写api？如果你写过就知道与Markdown语法搏斗的痛苦。试试列表和代码混写。

[youyongsong]

How do you document your APIs? http://www.infoq.com/research/api-documentation
个人觉得Swagger很不错，还可以直接集成到Django,Flask等框架里，有点像KSS。

[janxin]

同意 @efi 的说法，markdown排版某些时候还是满痛苦的

[humiaozuzu]

用过好多，发现还是 confluence 好用。。。

[yylyyl]

Confluence +1

[JamesRuan]

自己撸了一个，没后台，没多项目，不支持markdown，但是支持一个比markdown更适合排版的自己发明的语言。

[egen]

mark一下，之前一直用 markdown 写文档，基本可以满足需求，不过觉得写的重复性的东西有点太多，看看有没有更好的方案

[XinRen]

关注

[subpo]

你们只收藏不贡献！
markdown不是必须，只要有个足够好用的编辑器就可以

[tanran]

apidoc很好用

[KMHook]

mark，学习

[kimmykuang]

mark下，回去细细观之