有没有类似 swagger 的开源工具

[gkiwi]

swagger 比较强大，但是 yaml 配置起来有点繁琐，特别是单文件里面配置东西的时候，几百行操作起来有点难度； 尝试了 easy-mock，UI 风格各方面都很棒，但是在注释和生成查阅类的文档，就不可以了；

所以想问下有没有两者的中间产品（且 MIT 开源），满足如下条件：

1. 可以使用类似 md 语法进行书写，并且可以很好的进行分组（一个 api 一个文档最棒）；
2. 支持类似 mockjs 语法（当然可以换成其它的）；
3. 生成文档容易阅读(swagger 就很棒了)；

swagger 研究的也不多，本地 run 起来过，但是详细 document 还没看。 blueprint 似乎不错，之前用过他们线上版本，但是还没进行过本地部署试用。

想问问大家有啥建议没

[xiubao]

有一款，你可以看下；是开源免费的
地址： http://www.doclever.cn

[gkiwi]

@xiubao #1 非常感谢。看了下功能方面很棒，不过：



这个我就不太敢用了。虽然不会拿去卖钱，但是内网使用，也算是为商业应用提供服务的，估计架构师那边过不了= =

[gkiwi]

@gkiwi #2 看到滴滴美团他们在用= = ::doge

[acoder2013]

http://apidocjs.com/ 这个还不错，只用写注释就可生成文档，不过不支持 mock

[xiubao]

@gkiwi 不会的，团队可直接线下部署；只要不是用来做商业用途，商业用途是指用来运营，倒卖；团队线下部署是肯定可以的，不会有任何问题

[xiaour]

看看我的 SAPI https://github.com/xiaour/spring.boot.sapi.starter

[backache]

@xiaour 要是能加上字段描述就好了