测试接口直接生成API文档，这个工具贼好用，你用过吗

ShowDoc一个非常适合团队的在线API文档工具，也支持用docker自建文档服务，不过为了方便演示，我直接用了平台在线服务。官网地址：

https://www.showdoc.com.cn/item/index

可以使用markdown语法来写API文档、数据字典文档、技术文档、在线excel文档。但像我这种资深的懒人程序员，其实更看重的是showdoc的自动化生成文档的特性，它可以从代码注释中自动生成API文档，或者搭配RunApi客户端（类似postman的api调试工具）一边调试接口、一边自动生成文档。

下边从头演示下，来瞅瞅这玩意好用在哪？

初识 ShowDoc

ShowDoc新建项目可选常规的API文档、在线表格、或者单页文档（不支持目录分层），允许对项目文档设置访问密码，自定义域名，这里并不是真正意义上的“域名”，只是在文档服务域名后加了一级目录，例如：

www.showdoc.com.cn/程序员内点事

可以复制现有的项目，或直接导入Postman、swagger的API接口配置Json文件。提供的开放API是自动化生成文档的关键，先记住有api_key、api_token这两个属性，后边详细讲。

进入项目后点击右上角 + 编辑文档，ShowDoc预置了几种文档模板，也可以把自定义的文档存为模板；支持在线Mock服务，提前定义好接口的数据格式，先提供在线临时接口，这样就可以和前端同步开发，后边无缝切换；还有个简单的API在线测试功能。

在线表格样式很