OfficeIMO.Html.Pdf 1.0.0

OfficeIMO.Html.Pdf

First-party bidirectional HTML/PDF conversion for OfficeIMO.

OfficeIMO.Html.Pdf is a thin adapter. It does not introduce a browser-grade HTML/CSS renderer or a second PDF parser. Instead, it exposes one named HTML/PDF bridge while reusing the existing OfficeIMO ingestion, logical read, and PDF engines:

• Semantic profile: HTML → OfficeIMO.Markdown.Html → MarkdownDoc → OfficeIMO.Markdown.Pdf → OfficeIMO.Pdf
• Document profile: HTML → OfficeIMO.Word.Html → WordDocument → OfficeIMO.Word.Pdf → OfficeIMO.Pdf
• Semantic PDF profile: PDF → OfficeIMO.Pdf logical model → headings, paragraphs, lists, tables, and placeholders as semantic HTML
• Positioned review profile: PDF → OfficeIMO.Pdf logical model → page wrappers with positioned text/table/link/form hints

using OfficeIMO.Html.Pdf;

string html = """
<h1>Quarterly update</h1>
<p>Generated by OfficeIMO.</p>
<table>
  <tr><th>Area</th><th>Status</th></tr>
  <tr><td>PDF bridge</td><td>Green</td></tr>
</table>
""";

html.SaveAsPdf("quarterly-update.pdf", new HtmlPdfSaveOptions {
    Profile = HtmlPdfProfile.Semantic
});

using OfficeIMO.Html.Pdf;

byte[] documentPdf = html.SaveAsPdf(HtmlPdfSaveOptions.CreateDocumentProfile());

using OfficeIMO.Html.Pdf;

string html = PdfHtmlConverter.ToHtml("quarterly-update.pdf", new PdfHtmlSaveOptions {
    Profile = PdfHtmlProfile.Semantic
});

using OfficeIMO.Html.Pdf;

PdfHtmlConverter.SaveAsHtml("quarterly-update.pdf", "quarterly-update-review.html", new PdfHtmlSaveOptions {
    Profile = PdfHtmlProfile.PositionedReview,
    IncludeLinkAnnotations = true,
    IncludeFormWidgets = true,
    ImageExportMode = PdfHtmlImageExportMode.EmbeddedDataUri
});

using OfficeIMO.Html.Pdf;

HtmlPdfProfileContract contract = HtmlPdfProfileContracts.Get(HtmlPdfProfile.Semantic);

Console.WriteLine(contract.Id);
Console.WriteLine(contract.FidelityContract);

using OfficeIMO.Html.Pdf;

PdfHtmlProfileContract contract = PdfHtmlProfileContracts.Get(PdfHtmlProfile.PositionedReview);

Console.WriteLine(contract.Id);
Console.WriteLine(contract.UnsupportedScope);
Console.WriteLine(string.Join(", ", contract.ReviewSignals));

using OfficeIMO.Html.Pdf;

byte[] pdf = File.ReadAllBytes("quarterly-update.pdf");
string reviewHtml = PdfHtmlConverter.ToHtml(pdf, new PdfHtmlSaveOptions {
    Profile = PdfHtmlProfile.PositionedReview,
    IncludeMetadata = true
});

using OfficeIMO.Html.Pdf;

PdfHtmlConversionResult result = PdfHtmlConverter.ToHtmlResult("quarterly-update.pdf", new PdfHtmlSaveOptions {
    Profile = PdfHtmlProfile.PositionedReview,
    IncludeLinkAnnotations = true
});

Console.WriteLine(result.Summary.ProfileId);
Console.WriteLine(result.Summary.ImagePlacementCount);

Use the semantic profile for articles, documentation, simple reports, and HTML that should become structured text. Use the document profile when the existing Word HTML converter is a better source model for the HTML being processed. HtmlPdfSaveOptions.CreateDocumentProfile() is the practical HTML-to-PDF preset for local/trusted print HTML with CSS, images, links, tables, and page-break hints; CreateTrustedDocumentProfile() also enables the trusted Word HTML stylesheet behavior. HtmlPdfSaveOptions.GetResourcePolicySummary() returns the active stylesheet/image resource policy, and document-profile HTML import diagnostics such as blocked stylesheets are forwarded into HtmlPdfSaveOptions.ConversionReport.

Use PDF semantic HTML for search, indexing, export, and review workflows where clean structure matters. Use positioned review HTML when callers need a page-oriented view of extracted PDF text/table/link/form/image geometry. Positioned image placeholders include CSS coordinates for browser review and a data-matrix attribute with the original PDF image transform for diagnostics, and complete extracted image files are embedded as data:image/...;base64,... URIs by default. Set ImageExportMode = PdfHtmlImageExportMode.PlaceholderOnly when callers need lightweight review HTML without embedded image bytes. Images whose drawing invocation cannot be matched are still emitted as page-scoped placeholders with a conversion warning instead of being silently dropped.

HtmlPdfProfileContracts.All and PdfHtmlProfileContracts.All expose stable profile identifiers, pipeline descriptions, intended use, fidelity guarantees, supported HTML/CSS/resource or PDF review signals, diagnostics, renderer boundaries, and unsupported scope for wrappers, manifests, UI selectors, and product docs. They are deliberately descriptive contracts rather than renderer switches: callers still choose behavior through HtmlPdfSaveOptions.Profile and PdfHtmlSaveOptions.Profile.

PdfHtmlConverter.ToHtmlResult(...) returns the generated HTML plus a PdfHtmlExportSummary with selected page numbers, text/table/image/link/form counts, image-placement counts, warning count, image export mode, and the active profile fidelity contract. Use it for sidecars, migration reports, and visual review galleries instead of scraping generated HTML.