如何从OpenAPI 3.0生成PDF或标记？

Question

我有一个OpenAPI 3.0规范，我想从中生成一个PDF，以便可以将其提供给最终用户。

当前，诸如swagger-spec-to-pdf或swagger2markup之类的工具仅支持Swagger 2.0，但不支持OpenAPI 3.0。是否可以根据OpenAPI 3.0规范生成PDF，而无需将其转换为Swagger 2.0？

Answer 1

我刚刚发现RapiPDF，它能够生成的OpenAPI 3.0定义PDF。

但它仍然不是我正在寻找的理想工具。到目前为止，我发现了这些限制：

• 没有 CLI，仅在浏览器中运行。所以我不能在自动化管道中使用它。
• 不支持回调
• 生成的文档中没有示例

Answer 2

一种可能的解决方案是将您的OpenAPI 3.0定义转换为HTML文档，然后使用浏览器的“保存为PDF”功能将HTML转换为PDF。

跟着这些步骤：

1. 转到https://editor.swagger.io。
2. 粘贴您的OpenAPI 3.0 YAML / JSON定义。
3. 选择生成客户端> html。
4. 下载并解压缩文件。
5. index.html在浏览器（例如Chrome）中打开页面。
6. 选择文件>打印，更改目的地，以保存为PDF格式，并保存网页。