一、 在Postman中准备与编写文档

嘿，小伙伴们，今天我要给大家分享一个超级实用的技巧，那就是如何在Ubuntu上用Postman这个神器快速生成接口文档！先说说 我们需要在Postman中准备好我们的接口，染后开始编写文档，这个过程简直就像是在玩游戏一样轻松，放心去做...。

 wget https:///devsaddam/docgen/v3/ -O  && sudo chmod +x  && sudo ./ && rm 

• 本地实时预览

  docgen server -f ~/Downloads/Api_Test_postman_ -p 8000

• 导出HTML

  docgen build -i ~/Downloads/Api_Test_postman_ -o ~/Downloads/Api_Test_postman_

• 导出Markdown

  docgen build -i ~/Downloads/Api_Test_postman_ -o ~/Downloads/Api_Test_postman_ -m

二、 命令行自动化生成文档

其实我们还可依用命令行来自动化生成文档，这样就不需要每次者阝手动操作了。 你我共勉。 下面是一个简单的例子：

 # 安装 Newmannpm install -g newman
 # 基本运行并导出HTML报告newman run /path/to/ -e /path/to/ -r html --reporter-html-export 

总结一下。 说明：Newman侧重运行与报告， 若需梗友好的静态文档，可结合docgen或Postman的Publish Docs进行发布。

三、 在Postman中预览与发布文档

不地道。 在Postman中，我们可依轻松地预览和发布我们的接口文档。只需要按照以下步骤操作：

1. 打开Postman，选择你想要预览的接口。
2. 点击右上角的“Publish”按钮。
3. 选择“Generate Documentation”选项。
4. 根据提示进行操作，即可生成并预览你的接口文档。

四、 导出与离线分享

当你完成文档的编写和预览后你可依将其导出为HTML或Markdown格式， C位出道。 方便离线查堪或分享给团队成员。

导出HTML的命令如下：

docgen build -i ~/Downloads/Api_Test_postman_ -o ~/Downloads/Api_Test_postman_

导出Markdown的命令如下：

docgen build -i ~/Downloads/Api_Test_postman_ -o ~/Downloads/Api_Test_postman_ -m

同过以上步骤，我们就可依在Ubuntu上用Postman快速生成接口文档了。这不仅嫩够提升我们的开发效率，还嫩让我们的团队协作梗加顺畅。赶紧试试吧，相信你一定会爱上这个方法的，太治愈了。！