简介
Gotenberg 是一个开源的文档转换服务，使用 Chromium 和 LibreOffice 支持将多种文档格式（HTML、Markdown、Word、Excel 等）转换为PDF。
安装
这里我们使用docker来快速安装与运行gotenberg。
docker run --rm -d -p 3000:3000 gotenberg/gotenberg:8
安装完成后，我们可以通过访问 http://localhost:3000 来使用 gotenberg 的 API。 实际请求地址请根据服务器ip和使用的端口进行调整。
使用
Gotenberg提供了 HTTP API，你可以通过发送 HTTP 请求来使用它。
下面是Gotenberg 的 API文档 的一下简单使用示例,更多的API你可以通过访问 官方文档 来进行查看。
1.网页地址(URL)转PDF
请求路由:
POST /forms/chromium/convert/url
请求参数 multipart/form-data:
| 参数名 | 类型 | 是否必须 | 说明 |
| url | string | 是 | 要转换的网页地址(URL)地址 |
示例
curl \ --request POST http://localhost:3000/forms/chromium/convert/url \ --form url=https://my.url \ -o my.pdf
postman 模拟请求结果
2.HTML转PDF
请求路由:
POST /forms/chromium/convert/html
请求参数 multipart/form-data:
| 参数名 | 类型 | 是否必须 | 说明 |
| files | file | 是 | index.html文件 |
注意:上传的 html 名称必须为 index.html
示例
curl \ --request POST http://localhost:3000/forms/chromium/convert/html \ --form files=@/path/to/index.html \ -o my.pdf
postman模拟请求结果
3.Office文档转换为PDF
请求路由:
POST /forms/libreoffice/convert
请求参数 multipart/form-data:
| 参数名 | 类型 | 是否必须 | 说明 |
| files | file | 是 | Office文档 |
示例
curl \ --request POST http://localhost:3000/forms/libreoffice/convert \ --form files=@/path/to/file.docx \ -o my.pdf
postman 模拟请求结果
总结
Gotenberg 是一个方便的开源工具，用于将各种格式的文档转换为 PDF 。它可以通过 Docker 容器快速安装运行，提供简单的 HTTP API 接口，使得文档转换过程变得简单易用。
你只需要发送相应的 HTTP 请求，就可以将 URL、HTML、Markdown、Word、PPT 或 Excel 等文件转换为 PDF，并下载转换后的文件。
请注意，具体的安装和使用步骤可能会根据 Gotenberg 的版本和你的系统环境有所不同。
建议参考 Gotenberg 的官方文档以获取最新的安装和使用指南。
