MiniPdf 0.41.1

MiniPdf for .NET

The stable MiniPdf implementation for converting Office files to PDF from .NET applications or the command line. It runs without Microsoft Office, LibreOffice, Adobe Acrobat, or COM automation.

Project home · Online demo · Rust implementation

Features

• Excel to PDF conversion (.xlsx)
• Word to PDF conversion (.docx)
• PowerPoint to PDF conversion (.pptx)
• Minimal dependencies — lightweight; relies almost entirely on built-in .NET APIs
• Serverless-ready — no COM, no Office installation, no Adobe Acrobat — runs anywhere .NET runs
• .NET library, global tool, and standalone Native AOT binaries
• Valid PDF 1.4 output
• 100% open-source & free — Apache 2.0 licensed, commercial use welcome; just keep the attribution. PRs & contributions are even better!

Install

dotnet add package MiniPdf

Usage

using MiniSoftware;

// Excel to PDF
MiniPdf.ConvertToPdf("data.xlsx", "output.pdf");

// Word to PDF
MiniPdf.ConvertToPdf("report.docx", "output.pdf");

// PowerPoint to PDF
MiniPdf.ConvertToPdf("slides.pptx", "output.pdf");

// File to byte array
byte[] pdfBytes = MiniPdf.ConvertToPdf("data.xlsx");

// Render selected Excel sheets by name or 1-based index
MiniPdf.ConvertToPdf("data.xlsx", "selected.pdf", new MiniPdfConversionOptions
{
  Sheets = new[] { "Summary", "Details" },
  SheetIndexes = new[] { 1, 3 },
});

// Stream to byte array
using var stream = File.OpenRead("data.xlsx");
byte[] pdfBytesFromStream = MiniPdf.ConvertToPdf(stream);

// Stream directly to another stream without allocating the complete PDF byte array
stream.Position = 0;
using var output = File.Create("output.pdf");
MiniPdf.ConvertToPdf(stream, output);

Conversion Options

MiniPdf.ConvertToPdf("data.xlsx", "compact.pdf", new MiniPdfConversionOptions
{
  Sheets = new[] { "Summary", "Details" },
  Compress = true,
  FitToPage = true,
  Landscape = true,
  PrintScale = 70,
  RowsPerPage = 80,
});

Sheet selection and layout options apply to XLSX input. Compress controls PDF content-stream compression for every supported format.

Custom Fonts

Register TrueType .ttf or .ttc fonts once at application startup when the host has limited system fonts, such as a container or Blazor WebAssembly app.

MiniPdf.RegisterFont("NotoSansSC", File.ReadAllBytes("Fonts/NotoSansSC-Regular.ttf"));
MiniPdf.ConvertToPdf("report.docx", "report.pdf");

Command Line

Install the .NET global tool:

dotnet tool install --global MiniPdf.Cli
minipdf report.docx -o report.pdf

Standalone Native AOT binaries for Windows, Linux, and macOS are available on the GitHub Releases page. See the CLI reference for commands and options.

Benchmark

MiniPdf output is compared against LibreOffice as the reference renderer across 373 test cases.

Detailed reports:

• XLSX Benchmark Report
• DOCX Benchmark Report
• Issue Files Xlsx Report
• Issue Files Docx Report

Links

• Project portal: https://github.com/mini-software/MiniPdf
• .NET CLI: https://www.nuget.org/packages/MiniPdf.Cli
• API source: https://github.com/mini-software/MiniPdf/blob/main/src/MiniPdf/MiniPdf.cs
• License: Apache-2.0