【Tools】如何通过swagger导出离线接口文档

现在 https://editor.swagger.io/ 开启了收费模型，导致无法白嫖功能，最新我的做法是通过OpenAPI Generator来导出文档，我本地的JDK版本是17，需要注意的是JDK版本，我使用的要求本地JDK不能低于JDK11，还在使用JDK8的兄弟们要注意了。

# 安装OpenAPI Generator
npm install @openapitools/openapi-generator-cli -g

# 生成HTML文档
openapi-generator-cli generate -i swagger.json -g html2 -o ./docs/html

# 生成Markdown文档
openapi-generator-cli generate -i swagger.json -g markdown -o ./docs/markdown

# 生成Word文档（通过HTML转换）
openapi-generator-cli generate -i swagger.json -g html -o ./docs/word

官方文档：https://openapi-generator.tech/docs/installation

---

【下面内容已变成收费功能】

1. 登录的 Swagger Editor 页面，打开开发者工具（F12），复制api-docs返回的Respose
   

2. 登录 https://editor.swagger.io/
   

3. 将第一步中复制的api-docs返回的Respose粘贴到页面左侧黑框中，找到Generate Client - html 即可导出html格式的接口文档