如何从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

[一种可能的解决方案是将您的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，然后保存页面。

Answer 2

我刚刚发现RapiPDF能够从OpenAPI 3.0定义生成PDF。

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

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