OfficeIMO.Html.Pdf 3.6.0

OfficeIMO.Html.Pdf

OfficeIMO.Html.Pdf joins the HTML and PDF engines in both directions: it renders HTML to PDF, exports PDF-backed HTML page images (PNG, JPEG, TIFF, WebP and SVG), and converts PDF to semantic or positioned-review HTML. OfficeIMO.Html owns parsing, CSS and the provider-neutral layout scene and does not reference OfficeIMO.Pdf.

Use OfficeIMO.Html.Pdf.Browser when the source is a live website or its final output depends on JavaScript or browser layout. That package asks HtmlTinkerX to capture the page, then opens the generated bytes as a normal OfficeIMO.Pdf.PdfDocument. Browser capture is explicit; this managed renderer does not fall back to Chromium automatically.

Install

dotnet add package OfficeIMO.Html.Pdf

HTML to PDF

See the HTML renderer guide for conversion, explicit render profiles and shared image options.

ZIP site bundles

See bounded ZIP site-bundle PDF conversion.

Paged-media and PDF semantics

See the paged-media, tagging and Formula attachment contract.

Fonts and text shaping

See the shared HTML/PDF font and shaping settings.

PDF to HTML

using OfficeIMO.Drawing;
using OfficeIMO.Html.Pdf;
using OfficeIMO.Pdf;

PdfDocument sourcePdf = PdfDocument.Load("quarterly-update.pdf");
PdfHtmlExportOptions semanticOptions = PdfHtmlExportOptions.CreateSemanticProfile(
    OfficeVisualThemeKind.TechnicalDocument);
semanticOptions.ReadOptions = new PdfLoadOptions {
    PageSelection = PdfPageSelection.Parse("1-20"),
    Pipeline = new PdfUnderstandingPipelineOptions { MaxPages = 20 }
};
string semantic = sourcePdf.ToHtml(semanticOptions);

PdfHtmlExportOptions reviewOptions = PdfHtmlExportOptions.CreatePositionedReviewProfile(
    OfficeVisualThemeKind.Report);
reviewOptions.ImageExportMode = PdfHtmlImageExportMode.EmbeddedDataUri;
OfficeIMO.OfficeConversionReport saveReport = sourcePdf.SaveAsHtml("quarterly-review.html", reviewOptions);
string review = sourcePdf.ToHtml(reviewOptions, out OfficeIMO.OfficeConversionReport report);
foreach (OfficeIMO.OfficeDiagnostic diagnostic in report.Diagnostics) {
    Console.WriteLine($"{diagnostic.Code}: {diagnostic.Message}");
}

The named profiles emit the shared responsive OfficeIMO document shell, stable profile metadata, and adapter-owned PDF review styles. ToHtml(options, out report), its async result and SaveAsHtml expose immutable OfficeConversionReport snapshots after conversion completes. The positioned-review profile also enables inert link and form-widget overlays. Set IncludeDefaultStyles = false to omit the theme and presentation layer. Positioned output still emits its minimal structural CSS because absolute page geometry is part of that profile's fidelity contract.

Choose semantic HTML when readable headings, paragraphs, lists, and tables matter most. Choose positioned review when page geometry and visual comparison matter most. Semantic output reports its unavoidable reflow as a typed approximation. Both profiles report omitted vectors, images, links, forms, annotations, and outlines as typed omissions when the selected profile or options cannot represent them. report.HasLoss and report.ThrowIfLoss() therefore provide a strict acceptance gate; ordinary semantic conversion is expected to report approximation rather than claim pixel fidelity.

PdfHtmlImageExportMode.PlaceholderOnly retains readable image metadata but omits the source pixels and reports that omission. EmbeddedDataUri embeds supported image files within the configured byte and output-size limits and reports any fallback to a placeholder. Fully transparent and unplaced resources are suppressed, while images whose clips, soft masks, unresolved transparency masks, or unsupported blend modes could reveal hidden pixels are represented without the raw data URI and reported as typed omissions. Supported opacity and blend modes are mapped to CSS with diagnostics where browser compositing can differ from PDF compositing.

PDF-to-HTML profiles describe how an existing PDF is projected to review HTML. They are unrelated to HTML-to-PDF, which has one direct rendering path. HTML-to-PDF and HTML-to-PNG/JPEG/TIFF/SVG/WebP use the same HtmlRenderOptions scene and diagnostics; HtmlPdfExportOptions extends that shared options type with PDF-only settings. PDF page images use OfficeIMO.Pdf's ToImage(options) / ExportImages(...) API instead of routing through HTML. An image is embedded into HTML as a resource; turning image pixels into document structure is an OCR workflow, not an image-rendering profile.

When the source is an opened PdfDocument, positioned review uses the shared PDF drawing renderer to retain supported vector artwork, clipping, paint order, images, and embedded fonts as an embedded SVG image. Text remains selectable. Browser font substitution can affect text whose fonts are unavailable, and renderer diagnostics appear in the conversion report.

The logical positioned projection is used for pages with form widgets, restricted reading-order projection, or image settings that require placeholders, omission, or a smaller byte limit. OCR-only pages keep the visual appearance layer and add a transparent searchable text overlay. Check the report for content that could not be reproduced; positioned review is not a guarantee of identical appearance for every PDF.

Semantic output uses the shared crop-, rotation-, spanning-band-, and column-aware PDF reading order by default. Set PdfHtmlExportOptions.UseSharedPageReadingOrder = false only when source sequence is deliberately preferred; positioned-review output always retains source geometry.

PdfHtmlExportOptions.ReadOptions configures the canonical semantic read for an opened PdfDocument. Existing PageRanges take precedence over ReadOptions.PageSelection; the profile, layout, and semantic budgets still come from ReadOptions. The native read uses the loaded source document and these semantic settings.

Targets and license

• Targets: netstandard2.0, net8.0, net10.0.
• License: MIT.
• Repository: EvotecIT/OfficeIMO

Dependency footprint

• External: None beyond AngleSharp/AngleSharp.Css already isolated in OfficeIMO.Html; no browser process or native HTML renderer.
• OfficeIMO: OfficeIMO.Html, OfficeIMO.Pdf, and OfficeIMO.Core own layout, rendering, reverse projection, and reports.

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

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.Html.Pdf are published in the generated operation contract.