OfficeIMO.Pdf 3.6.0

OfficeIMO.Pdf

Create, read, edit and combine PDF files in .NET. OfficeIMO.Pdf is OfficeIMO's own PDF engine, with no third-party PDF library, browser or Office installation. It also fills forms, stamps and redacts pages, protects files with passwords and checks PDF/A and PDF/UA output.

Install

dotnet add package OfficeIMO.Pdf

Optional packages:

dotnet add package OfficeIMO.Security       # certificate signatures
dotnet add package OfficeIMO.Pdf.Ocr        # searchable scans, with an OCR provider
dotnet add package OfficeIMO.Pdf.Word       # PDF to Word; also .Pdf.Excel and .Pdf.PowerPoint

To turn Word, Excel, PowerPoint or Markdown into PDF, install the source format's adapter (OfficeIMO.Word.Pdf, OfficeIMO.Excel.Pdf, OfficeIMO.PowerPoint.Pdf, OfficeIMO.Markdown.Pdf) and call SaveAsPdf on that document.

Targets netstandard2.0, net8.0 and net10.0, plus net472 on Windows.

Create a report

using OfficeIMO.Pdf;

PdfDocument.Create(pdf => pdf.Content(content => content
        .H1("Service review")
        .AddParagraph(p => {
            p.AddText("All scheduled checks passed. ");
            p.AddText("Two follow-ups remain open.").SetBold();
        })
        .AddTable(new[] {
            new[] { "Task", "Owner", "Due" },
            new[] { "Rotate certificates", "Platform", "4 Nov" },
            new[] { "Review backups", "Operations", "11 Nov" }
        })))
    .Meta(title: "Service review", author: "Operations")
    .Save("Service-review.pdf");

Page margins follow the Modern theme unless PdfCreateOptions.Theme names another. PdfCreateOptions also sets the page size, fonts, tagging and compliance profile.

A single flow spacer is limited to 1,000 page or column traversal steps and cannot exceed 1,000 configured page heights. Larger spacing fails with InvalidDataException. Set MaxGeneratedPages when the total output page count also needs a limit.

Read text and tables

using OfficeIMO.Pdf;

PdfDocument pdf = PdfDocument.Load("Service-review.pdf");
PdfDocumentReadResult result = pdf.Read();

foreach (PdfLogicalPage page in result.Pages) {
    Console.WriteLine($"Page {page.PageNumber}: {page.Paragraphs.Count} paragraphs, {page.Tables.Count} tables");
}
Console.WriteLine(result.ExtractMarkdown());

For files from outside your organization, pass PdfLoadOptions with read limits, as shown in the guide.

Combine, split and reorder pages

using OfficeIMO.Pdf;

PdfDocument.Load("Service-review.pdf")
    .MergeWith("Service-review.pdf")
    .Pages.Rotate(90, "2")
    .UpdateMetadata(title: "Review pack")
    .Save("Review-pack.pdf");

PdfDocument pack = PdfDocument.Load("Review-pack.pdf");
pack.Pages.Extract("1").Save("Cover.pdf");
IReadOnlyList<PdfDocument> pages = pack.Pages.Split();
for (int i = 0; i < pages.Count; i++) pages[i].Save($"Review-pack-{i + 1}.pdf");

Page operations return a new document; the source file is never changed in place. Page numbers and ranges are 1-based.

Pages.Insert, Pages.Append and Pages.Prepend retain ordinary AcroForm fields. Incoming name collisions use suffixes such as Shared_source2; hierarchical fields keep their parent and sibling relationships. General merge keeps only the primary form by default; choose Forms = PdfMergeStructureMode.Combine to retain incoming fields. See the page composition guide for form, action and signature restrictions.

Fill a form

using OfficeIMO.Pdf;

PdfDocument.Create(pdf => pdf.Content(content => content
        .H1("Application")
        .TextField("Applicant.Name")
        .TextField("Approval.Status")))
    .Save("Application.pdf");

PdfDocument.Load("Application.pdf")
    .Forms.FillAndFlatten(new Dictionary<string, string> {
        ["Applicant.Name"] = "Adele Vance",
        ["Approval.Status"] = "Approved"
    })
    .Save("Application-filled.pdf");

Forms.Fill keeps the fields editable; FillAndFlatten makes the values part of the page.

Protect with a password

using OfficeIMO.Pdf;

PdfDocument.Create(pdf => pdf.Content(content => content
        .H1("Salaries 2027")
        .AddParagraph(p => p.AddText("Confidential."))),
        new PdfCreateOptions().SetEncryption("open-password", ownerPassword: "owner-password"))
    .Save("Salaries.pdf");

Convert a PDF back to Word

using OfficeIMO;
using OfficeIMO.Pdf;
using OfficeIMO.Pdf.Word;

PdfDocument pdf = PdfDocument.Load("Service-review.pdf");
OfficeConversionReport report = pdf.SaveAsWord("Service-review.docx");
Console.WriteLine($"Loss: {report.HasLoss}");

Reconstruction from a fixed-layout PDF is semantic: paragraphs, headings, lists and tables come back as editable Word content, and the report lists what could not be recovered.

More

• PDF guide: page layout and typography, fonts, headers and footers, images, stamps and watermarks, redaction, annotations, signatures, attachments, tagged output, PDF/A and PDF/X, page images, invoices and inspection.
• PDF current state, PDF conversion support and the generated operation contract.
• Examples and the migration guide.
• PowerShell: PSWriteOffice (New-OfficePdf, Open-OfficePdf).

Dependencies: OfficeIMO.Core only; the PDF parser, writer, renderer and password encryption are OfficeIMO code. MIT licensed.

Generated capability summary

This table is generated from the package-neutral OfficeIMO operation catalog. The detailed source contracts remain authoritative for feature-level behavior and limitations.

The complete rows for OfficeIMO.Pdf are published in the generated operation contract.