HtmlToOpenXml

HtmlToOpenXml is a .NET library designed to convert HTML content (ranging from simple to advanced) into plain OpenXml components. It is useful for scenarios such as converting user comments or web content into Microsoft Word documents.

Supported Runtimes:

• .NET Framework 4.6.2
• .NET Standard 2.0
• .NET 8 (LTS)
• .NET 10 (LTS)

Dependencies:

• DocumentFormat.OpenXml
• AngleSharp

To evaluate the performance of the library, you can run the benchmark tool provided in the examples/Benchmark directory. The process involves building the project in Release mode and then executing the performance tests against multiple target runtimes (e.g., .NET Framework 4.8 and .NET 8.0).

# Build the project in Release mode
dotnet build -c Release

# Run the performance test targeting multiple runtimes
dotnet run -c Release -f net8.0 --runtimes net48 net8.0

When implementing custom features or debugging the output of HtmlToOpenXml, you can inspect the underlying OpenXml structure of a .docx file:

1. Create a document in Microsoft Word or Apple Pages that represents your desired output.
2. Save the file as a .docx.
3. Rename the file extension from .docx to .zip.
4. Extract the contents of the zip file.
5. Inspect the following XML files to understand the structure:
   • document.xml: The main document content.
   • numbering.xml: Definitions for lists.
   • styles.xml: Document styles.

For technical reference, consult the MDN HTML documentation and the OpenXml MSDN documentation.