开源可商用 .NET Office 转 PDF 工具/库

开源可商用 .NET Office 转 PDF 工具/库 - MiniPdf

MiniPdf 是晚辈开发 MiniExcel、Word 后最新开发工具，不需要安装任何软体，轻量化，开源可免费商用主要解决目前好用的转换库要收费，需要安装 LibreOffice、office 或 docker 情况特点1.无需 COM、Office、Adobe Acrobat2.其他语言可以用预编译独立二进制文件，支援 Windows / Linux / macOS，无需安装 .NET 执行阶段3.完全开源免费，基于 Apache 2.0 授权，可自由商用，无任何限制

MiniPdf 目前只能处理基本的转换需求。对于复杂或高度自订的 Office 文件，转换结果可能不够理想。如果遇到相容性问题，欢迎提交 Issue 或发起 Pull Request，一起让开源社群变得更好！

假如喜欢 MiniPdf 的理念，期待你的 star 跟推荐🙌

GitHub : https://github.com/mini-software/MiniPdfGitee : https://gitee.com/dotnetchina/MiniPdf

介绍

一个极简、轻量化的 .NET 库，用于将 Office 文件转换为 PDF。

在线演示 — 在浏览器中快速体验，无需安装。

浏览器可用字体有限，渲染效果可能不够理想。建议在本地电脑上测试以获得最佳效果。

QQ群 - 1群 : 813100564 / 2群 : 579033769 / 3群 : 625362917 / 4群 : 907750429

功能特性

Excel 转 PDF
— 将 .xlsx 文件转换为 PDF
Word 转 PDF
— 将 .docx 文件转换为 PDF
极少依赖
— 轻量化设计，几乎仅使用 .NET 内置 API
Serverless 就绪
— 无需 COM、无需安装 Office、无需 Adobe Acrobat — 有 .NET 即可运行
Native AOT
— 预编译独立二进制文件，支持 Windows / Linux / macOS，无需安装 .NET 运行时
标准 PDF 1.4
格式输出
完全开源免费
— 基于 Apache 2.0 协议，可自由商用，无任何限制，注明出处即可。欢迎提交 PR 一起贡献！
图表
— 目前支持尚不完善

快速开始

通过 NuGet 安装

dotnet add package MiniPdf

使用方式

using MiniSoftware;// Excel 转 PDFMiniPdf.ConvertToPdf("data.xlsx", "output.pdf");// Word 转 PDFMiniPdf.ConvertToPdf("report.docx", "output.pdf");// 文件转字节数组byte[] pdfBytes = MiniPdf.ConvertToPdf("data.xlsx");// 流转字节数组usingvar stream = File.OpenRead("data.xlsx");byte[] pdfBytes = MiniPdf.ConvertToPdf(stream);

自定义字体

如果运行环境系统字体有限（例如容器或 Blazor WASM），请在转换前先注册字体。

using MiniSoftware;// 建议在应用启动时注册一个或多个字体MiniPdf.RegisterFont("NotoSansSC", File.ReadAllBytes("Fonts/NotoSansSC-Regular.ttf"));MiniPdf.RegisterFont("NotoColorEmoji", File.ReadAllBytes("Fonts/NotoColorEmoji.ttf"));MiniPdf.ConvertToPdf("report.docx", "report.pdf");

说明：

支持传入 TrueType .ttf 和 TrueType Collection .ttc 字体字节。
建议仅在启动阶段注册一次，避免重复注册。
已注册字体会优先于系统字体参与匹配。

命令行工具

MiniPdf 还提供命令行工具 MiniPdf.Cli，无需编写代码即可快速转换文件。

安装

dotnet tool install --global MiniPdf.Cli

使用方式

# 将 Excel 转为 PDF（输出: data.pdf）minipdf data.xlsx# 将 Word 转为 PDFminipdf report.docx# 指定输出路径minipdf report.docx -o /path/to/output.pdf# 注册自定义字体（适用于容器/无头环境）minipdf report.docx --fonts ./Fonts

命令说明

命令	说明
`minipdf <file>`	将 `.xlsx` / `.docx` 转换为 PDF
`minipdf convert <file> -o <out>`	转换并指定输出路径
`minipdf --version`	显示版本
`minipdf --help`	显示帮助

Native AOT 独立二进制文件

MiniPdf.Cli 支持 Native AOT（Ahead-of-Time，预编译）— 在构建阶段将 C# 代码直接编译为原生机器码，如同 C/C++ 编译一样，生成独立的可执行文件。运行时无需 .NET 运行时或 JIT 编译器。

优势：

零依赖
— 目标机器无需安装 .NET SDK 或运行时
即时启动
— 原生机器码，无 JIT 预热
体积小巧
— 单文件二进制，便于分发和部署
CI/CD 友好
— 下载即可运行，无需在流水线中安装 .NET

下载： 从 GitHub Releases 页面下载对应平台的二进制文件。

平台	文件
Windows x64	`minipdf-win-x64.zip`
Windows ARM64	`minipdf-win-arm64.zip`
Linux x64	`minipdf-linux-x64.tar.gz`
Linux ARM64	`minipdf-linux-arm64.tar.gz`
macOS x64	`minipdf-osx-x64.tar.gz`
macOS ARM64 (Apple Silicon)	`minipdf-osx-arm64.tar.gz`

使用方式（Linux / macOS 示例）：

# 下载并解压tar -xzf minipdf-linux-x64.tar.gz# 转换./minipdf report.docx -o report.pdf

使用方式（Windows 示例）：

# 解压 zip 后运行.\minipdf.exe report.docx -o report.pdf

免责声明：本内容来自平台创作者，博客园系信息发布平台，仅提供信息存储空间服务。