MiniPdf 0.1.0

MiniPdf

A minimal, zero-dependency .NET library for generating PDF documents from text and Excel (.xlsx) files.

Security: All PRs are automatically reviewed by Copilot AI and Azure AI security scan for vulnerabilities.

Features

• Text-to-PDF — Create PDF documents with positioned or auto-wrapped text
• Excel-to-PDF — Convert .xlsx files to paginated PDF with automatic column layout
• Zero dependencies — Uses only built-in .NET APIs (no external packages)
• Valid PDF 1.4 output with Helvetica font

Getting Started

Install via NuGet

dotnet add package MiniPdf

Requirements

• .NET 9.0 or later

Build

dotnet build

Run Tests

dotnet test

Usage

Simple Text PDF

using MiniPdf;

var doc = new PdfDocument();
var page = doc.AddPage(); // US Letter size by default

page.AddText("Hello, World!", x: 50, y: 700, fontSize: 24);
page.AddText("This is MiniPdf.", x: 50, y: 670, fontSize: 12);

doc.Save("output.pdf");

Auto-Wrapped Text

var doc = new PdfDocument();
var page = doc.AddPage();

var longText = "This is a long paragraph that will automatically wrap "
             + "within the specified width boundary on the page.";

page.AddTextWrapped(longText, x: 50, y: 700, maxWidth: 500, fontSize: 12);

doc.Save("wrapped.pdf");

Excel to PDF

using MiniPdf;

// One-liner: file to file
ExcelToPdfConverter.ConvertToFile("data.xlsx", "data.pdf");

// With options
var options = new ExcelToPdfConverter.ConversionOptions
{
    FontSize = 10,
    PageWidth = 595,   // A4
    PageHeight = 842,  // A4
    IncludeSheetName = true,
};

var doc = ExcelToPdfConverter.Convert("data.xlsx", options);
doc.Save("data.pdf");

Save to Stream or Byte Array

var doc = new PdfDocument();
doc.AddPage().AddText("Hello", 50, 700);

// To stream
using var stream = new MemoryStream();
doc.Save(stream);

// To byte array
byte[] bytes = doc.ToArray();

Project Structure

MiniPdf.sln
├── src/MiniPdf/              # Library
│   ├── PdfDocument.cs        # Document model
│   ├── PdfPage.cs            # Page with text placement
│   ├── PdfTextBlock.cs       # Text block data
│   ├── PdfWriter.cs          # PDF 1.4 binary writer
│   ├── ExcelReader.cs        # .xlsx parser (ZIP + XML)
│   └── ExcelToPdfConverter.cs# Excel-to-PDF public API
└── tests/MiniPdf.Tests/      # xUnit tests

License

MIT