OfficeIMO.Word.Html 1.0.44

OfficeIMO.Word.Html - Word and HTML conversion

OfficeIMO.Word.Html converts between HTML and OfficeIMO.Word documents. It is for document-shaped HTML that should become editable Word content, and for Word documents that should be exported as HTML.

Install

dotnet add package OfficeIMO.Word.Html

Quick start

using OfficeIMO.Word;
using OfficeIMO.Word.Html;

WordDocument document = "<h1>Hello</h1><p>Body</p>".LoadFromHtml(new HtmlToWordOptions());

string html = document.ToHtml(new WordToHtmlOptions {
    IncludeDefaultCss = true,
    ExportFootnotes = true,
    ExportEndnotes = true,
    ExportComments = true
});

HTML can also be appended to an existing body, header, or footer with AddHtmlToBody, AddHtmlToHeader, and AddHtmlToFooter.

What it maps

• HTML headings, paragraphs, inline formatting, links, images, SVG, lists, tables, captions, form controls, notes, headers, footers, and sections into Word content where supported.
• Word document metadata, paragraph/run styles, lists, tables, images, SVG, footnotes, endnotes, disabled form controls, comments, headers, footers, and optional CSS back to HTML.
• Stylesheets, inline CSS, local/remote resources, image policies, resource limits, and diagnostics through explicit options.
• Document language metadata between HTML lang and Word settings.

Import profiles

var safeOptions = HtmlToWordOptions.CreateUntrustedHtmlProfile();
safeOptions.MaxHtmlNodes = 5000;
safeOptions.DiagnosticHandler = diagnostic =>
    Console.WriteLine($"{diagnostic.Code}: {diagnostic.Source}");

WordDocument safeDocument = html.LoadFromHtml(safeOptions);

• CreateOfficeIMOProfile() keeps the compatibility-oriented defaults.
• CreateUntrustedHtmlProfile() keeps external document resources offline by default and enables bounded conversion.
• CreateTrustedDocumentProfile() enables document-provided stylesheet links for known-good HTML while keeping resource validation.
• new HtmlToWordOptions() embeds data URI images only; use a trusted/compatibility profile or set ImageProcessing = ImageProcessingMode.Embed for trusted remote image fetching.
• Local file images are not loaded by default; use a trusted/compatibility profile or add Uri.UriSchemeFile to AllowedImageUriSchemes for trusted local files.

Boundaries

• Word document modeling belongs in OfficeIMO.Word.
• HTML-to-Markdown ingestion belongs in OfficeIMO.Markdown.Html.
• HTML-to-PDF bridge behavior belongs in OfficeIMO.Html.Pdf.
• Full support matrices and roadmap detail belong in Docs/, not this README.

Deeper docs

• Word/HTML support matrix
• Word/HTML roadmap
• OfficeIMO.Word

Targets and license

• Targets: netstandard2.0, net8.0, net10.0; net472 is included when building on Windows.
• License: MIT.
• Repository: EvotecIT/OfficeIMO