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

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

• 请不要在回答技术问题时复制粘贴 AI 生成的内容

这是一个创建于 4048 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

API

Markdown

文档

24 条回复 • 2015-09-07 12:39:55 +08:00

Livid

MOD

PRO

2014 年 12 月 18 日

https://dash.readme.io/

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

aveline

2014 年 12 月 18 日

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

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

2014 年 12 月 18 日

关注

subpo

2014 年 12 月 18 日

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

subpo

2014 年 12 月 18 日

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

harryert

2014 年 12 月 18 日

mark，我也想知道。。。

lululau

2014 年 12 月 18 日

Github Enterprise

subpo

2014 年 12 月 18 日

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

efi

2014 年 12 月 18 日 via Android

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

youyongsong

2014 年 12 月 18 日

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

janxin

2014 年 12 月 18 日

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

humiaozuzu

2014 年 12 月 18 日

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

yylyyl

2014 年 12 月 19 日 via iPhone

Confluence +1

JamesRuan

2014 年 12 月 19 日 via Android

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

egen

2014 年 12 月 19 日

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

XinRen

2014 年 12 月 19 日

关注

subpo

2014 年 12 月 19 日

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

tanran

2014 年 12 月 19 日

apidoc很好用

KMHook

2014 年 12 月 19 日

mark，学习

kimmykuang

2014 年 12 月 19 日

mark下，回去细细观之

lguan

2014 年 12 月 20 日

我用redmine写过api文档，就是textile，用github的写过，就是markdown，最后发现，还是confluence的最好用，markdown我很喜欢用，但是有些东西不好做，比如，表格

zealic

2014 年 12 月 20 日

https://github.com/gollum/gollum

with:
GitHub Flavored Markdown

magicrolan

2015 年 3 月 19 日

以后看看吧
现在我也是迷茫

qw0258

2015 年 9 月 7 日

mark ，学习