简介

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 的官方文档以获取最新的安装和使用指南。

– 欢迎点赞、关注、转发、收藏【我码玄黄】，gonghao同名