好用的restful 接口文档生成

1. swagger

国外的，可以用yaml语言来编写

2. showdoc

国内的，可以在线测试接口并且生成固定格式的markdown的文档，也很不错