OfficeIMO.Reader.Pdf 3.0.0

OfficeIMO.Reader.Pdf - PDF reader adapter

OfficeIMO.Reader.Pdf is the selective PDF adapter over OfficeIMO.Reader.Core and the OfficeIMO.Pdf logical read model. It does not pull Word, Excel, PowerPoint, Email, or the all-adapters composition package.

Install

dotnet add package OfficeIMO.Reader.Pdf

Register

using OfficeIMO.Reader;
using OfficeIMO.Reader.Pdf;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddPdfHandler()
    .Build();

IReadOnlyList<ReaderChunk> chunks = reader
    .Read("invoice.pdf")
    .ToList();

Examples

Read page-aware Markdown chunks

using OfficeIMO.Reader;
using OfficeIMO.Reader.Pdf;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddPdfHandler()
    .Build();

foreach (var chunk in reader.Read("manual.pdf")) {
    Console.WriteLine($"Page {chunk.Location.Page}: {chunk.Id}");
    Console.WriteLine(chunk.Markdown ?? chunk.Text);
}

OfficeDocumentReadResult document = reader.ReadDocument("manual.pdf");
OfficeDocumentSearchResult matches = document.Search("installation");
Console.WriteLine(string.Join(", ", matches.Hits
    .SelectMany(hit => hit.Pages)
    .Select(page => page.Display)));

Read a stream with input limits

using OfficeIMO.Reader;
using OfficeIMO.Reader.Pdf;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddPdfHandler()
    .Build();

using var stream = File.OpenRead("large-report.pdf");
var chunks = reader.Read(stream, "large-report.pdf", new ReaderOptions {
    MaxChars = 12_000,
    MaxInputBytes = 100L * 1024L * 1024L
}).ToList();

foreach (var chunk in chunks.Where(chunk => chunk.Diagnostics != null)) {
    Console.WriteLine($"{chunk.Id}: {chunk.Diagnostics!.TableCount} table(s)");
}

Register alongside other ingestion adapters

using OfficeIMO.Reader;
using OfficeIMO.Reader.Html;
using OfficeIMO.Reader.Pdf;
using OfficeIMO.Reader.Zip;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddHtmlHandler()
    .AddPdfHandler()
    .AddZipHandler()
    .Build();

var chunks = reader.ReadFolder("KnowledgeBase", new ReaderFolderOptions {
    Recurse = true,
    DeterministicOrder = true,
    MaxFiles = 500
}).ToList();

What it emits

• Page-aware chunks with ReaderLocation.Page.
• Native fixed-page membership and geometry compatible with Reader Core location, search, and page-Markdown helpers.
• Markdown text, logical tables, column profiles, table diagnostics, and confidence signals.
• Source/security/form/catalog-metadata/open-action/active-content counters in ReaderChunk.Diagnostics.
• Document metadata for XMP, output intents, tagged structure, optional content/layers, attachments, security/signatures, navigation, links, forms, annotations, and passive actions.
• Passive action summaries without executable payloads.
• Image placeholders and visual geometry when available.
• Link annotations and typed form fields when available.

Boundaries

• Reader adapter configuration belongs here.
• PDF parsing, logical readback, and safety behavior belongs in OfficeIMO.Pdf.
• Shared extraction contracts belong in OfficeIMO.Reader.Core.

Targets and license

• Targets: netstandard2.0, net8.0, net10.0.
• License: MIT.

Dependency footprint

• External: None beyond the dependencies of its OfficeIMO format packages.
• OfficeIMO: OfficeIMO.Reader.Core and the first-party OfficeIMO.Pdf engine own parsing, logical recovery, chunks, assets, and diagnostics.

See the complete OfficeIMO package map for related formats and conversion paths.