Postman导出JSON文件轻松转换为HTML或Markdown

2024软件测试面试刷题，这个小程序（永久刷题），靠它快速找到工作了！（刷题APP的天花板）_软件测试刷题小程序-CSDN博客文章浏览阅读3k次，点赞85次，收藏12次。你知不知道有这么一个软件测试面试的刷题小程序。里面包含了面试常问的软件测试基础题，web自动化测试、app自动化测试、接口测试、性能测试、自动化测试、安全测试及一些常问到的人力资源题目。最主要的是他还收集了像阿里、华为这样的大厂面试真题，还有互动交流板块……_软件测试刷题小程序​编辑https://blog.csdn.net/AI_Green/article/details/134931243?spm=1001.2014.3001.5502https://blog.csdn.net/AI_Green/article/details/134931243?spm=1001.2014.3001.5502​编辑https://blog.csdn.net/AI_Green/article/details/134931243?spm=1001.2014.3001.5502​编辑https://blog.csdn.net/AI_Green/article/details/134931243?spm=1001.2014.3001.5502https://blog.csdn.net/AI_Green/article/details/134931243?spm=1001.2014.3001.5502

Postman 想必大家都不陌生，在软件开发和API测试的过程中，Postman 已经成为了一个不可或缺的工具。它不仅可以帮助我们设计、发送、测试和调试 HTTP 请求，还可以轻松地导出接口数据为JSON格式。然而，有时候为了更直观地向团队成员展示接口信息，即文档化，我们可能需要将这些JSON数据转换为更易于阅读的格式，如 HTML 或 Markdown。

你们可能会问了，不是有专门的接口文档管理工具吗，像 Swagger 之类的，咋不用呢？底层小测试用什么 Swagger，哪个方便用哪个。

为什么要将JSON转换为HTML或Markdown

我们都知道，Postman 只能导出 JSON 格式的文件，从易读性和直观性来讲，不是很方便，如果别人想看你的接口信息，只能将 JSON 文件导入 Postman。鉴于此，我们可以将 JSON 转换为 HTML 或 Markdown。

HTML 格式使得数据可以在网页浏览器中呈现，这对于展示复杂的嵌套数据或构建可视化报告非常有用。

Markdown 是一种轻量级的标记语言，它允许你使用简单的文本格式来编写文档，这些文档可以被转换为结构化的 HTML。Markdown 格式非常适合编写技术文档或报告，因为它既易于阅读又易于编写。

如何使用Postman将JSON转换为HTML或Markdown

Postman 本身并不直接支持将 JSON 转换为 HTML 或 Markdown，但你可以借助一些第三方工具或脚本来实现这一功能。我们可以使用免费的开源工具 docgen 来实现这一功能。

docgen 安装和卸载

1.工具链接

https://github.com/thedevsaddam/docgen

2.安装

• • Mac/Linux 安装

curl https://raw.githubusercontent.com/thedevsaddam/docgen/v3/install.sh -o install.sh \
&& sudo chmod +x install.sh \
&& sudo ./install.sh \
&& rm install.sh

• • Mac/Linux 卸载

curl https://raw.githubusercontent.com/thedevsaddam/docgen/v3/uninstall.sh -o uninstall.sh \
&& sudo chmod +x uninstall.sh \
&& sudo ./uninstall.sh \
&& rm uninstall.sh

• • Windows：直接下载二进制文件并设置环境变量。下载链接：https://github.com/thedevsaddam/docgen/releases

JSON 转换 HTML 和 Markdown

1.从 Postman 导出为 JSON 文件

2.JSON 转换 HTML 和 Markdown

• • 查看实时在线 HTML 文档

docgen server -f ~/Downloads/Api_Test_postman_collection.json -p 8000

---

---

• • 查看实时在线 Markdown 文档

docgen server -f ~/Downloads/Api_Test_postman_collection.json -p 8000 -m

---

---

• • 生成本地 HTML 文档

docgen build -i ~/Downloads/Api_Test_postman_collection.json -o ~/Downloads/Api_Test_postman_collection.html

---

---

• • 生成本地 Markdown 文档

docgen build -i ~/Downloads/Api_Test_postman_collection.json -o ~/Downloads/Api_Test_postman_collection.md -m

---

---

注意事项

在使用第三方工具 docgen 时，注意查看其文档和使用说明，以确保正确使用。通过上述方法，你可以轻松地将 Postman 导出的 JSON 文件转换为 HTML 或 Markdown 格式的文件，从而更方便地分享和展示 API 文档。

行动吧，在路上总比一直观望的要好，未来的你肯定会感谢现在拼搏的自己！如果想学习提升找不到资料，没人答疑解惑时，请及时加入群： 759968159，里面有各种测试开发资料和技术可以一起交流哦。

最后： 下方这份完整的软件测试视频教程已经整理上传完成，需要的朋友们可以自行领取【保证100%免费】

软件测试面试文档

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。