Swagger 作为一款广泛使用的 RESTful API 设计与文档化工具，多年来已成为开发者的标准配置。它不仅提供交互式的 API 调试界面，也支持将 API 规范导出为 JSON、Markdown 等多种通用格式。其中，JSON 格式便于后续的系统集成与自动化处理，而 Markdown 格式则能生成更适合人类阅读的文档。 本文将以 Swagger Petstore 开源示例项目为例，详细介绍如何高效地将 Swagger API 格式文件转换成 JSON、Markdown 乃至 PDF、Word 等其他实用格式，涵盖完整的操作流程与实用技巧。 ## 如何从 Swagger 中导出 JSON 文件 操作过程非常简单。在本地运行的 Swagger Petstore 服务界面中，开发者可以轻松定位到 `swagger.json` 文件的在线地址，通过鼠标右键选择“链接另存为”即可将其下载到本地。具体步骤如下：   ## 将 Swagger 文件导入到 Apifox ### Apifox 是什么？ Apifox 是一款功能强大的 API 一体化协作平台，其聚合了 API 设计（类似 Swagger）、调试（类似 Postman）、Mock 数据与性能测试（类似 JMeter）的核心能力。它不仅支持 HTTP、WebSocket、gRPC 等多种协议，还与主流 IDE 深度集成。在团队协作场景下，借助 Apifox 的 IDEA 插件可以一键同步接口变更，大幅提升 API 开发、测试与维护的效率。  ### 如何导入 Swagger 文件至 Apifox 首先，打开 Apifox 并创建一个新项目。随后导航至「项目设置 → 导入数据 → OpenAPI/Swagger → 文件导入」，选择您此前导出的 `swagger.json` 文件即可完成导入。  导入过程中，系统会提供文件内容的预览，您可以选择导入全部接口定义，或根据需求仅勾选部分接口进行导入，操作非常灵活。  导入成功后，在 Apifox 界面选择一个已配置的测试环境，即可开始对接口进行在线调试。下图展示了接口调用成功并返回数据的典型界面：  ## 将 OpenAPI 文件导出为 Markdown 文档 在 Apifox 中，将已导入的 OpenAPI（Swagger）规范导出为 Markdown 格式的步骤同样直观。进入「项目设置 → 导出数据 → Markdown 格式 → 导出」，即可生成一个结构清晰、便于分发的 Markdown 格式 API 文档。  导出的 Markdown 文件会自动生成文档目录，并详细列出每个接口的请求参数、响应示例等核心信息，可读性极佳。  ## 如何将 Markdown 文档转换为 PDF 与 Word 获得 Markdown 文件后，您可以借助多种工具将其转换为更通用的办公文档格式。您可以在搜索引擎中查找“Markdown 转 PDF”或“Markdown 转 Word”来找到大量在线或离线工具。以下推荐两种常见且高效的方法： - **使用 MarkText 编辑器**：这是一款开源的 Markdown 编辑器。您只需用 MarkText 打开导出的 `.md` 文件，然后通过「文件」菜单中的「导出」功能即可直接生成 PDF。  - **使用 VSCode 插件**：在强大的 VSCode 编辑器中，安装名为 **Markdown PDF** 的扩展插件。安装后，打开 Markdown 文件并点击右上角的预览图标（形如书本和放大镜），在预览页面的空白处右键单击，即可选择导出为 PDF、PNG 等多种格式。   **实用提示**：为了保证格式的准确性，建议先转换为 PDF 格式，再利用 PDF 转换工具或 Microsoft Word 等软件将其转换为 Word 文档，这样能最大程度地保持原有排版样式。 ## 操作总结 整个流程从 Swagger 导出 JSON，到导入 Apifox 统一管理，再到最终导出为 Markdown 及 PDF/Word，全程无需复杂的配置或编写额外代码，操作路径清晰、高效。此外，Apifox 作为一个功能全面的 API 管理工具，其价值远不止于文档格式转换，值得开发者进一步探索其团队协作、Mock 服务、自动化测试等高阶功能。  *进一步学习：* - 如何将 Swagger 导入 Postman 进行调试 - Swagger 中枚举（enum）类型的定义与使用详解