Aspose.HTML 22.5.0

.NET Standard 2.0 .NET Framework 2.0
There is a newer version of this package available.
See the version list below for details.
dotnet add package Aspose.HTML --version 22.5.0
NuGet\Install-Package Aspose.HTML -Version 22.5.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Aspose.HTML" Version="22.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Aspose.HTML --version 22.5.0
#r "nuget: Aspose.HTML, 22.5.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Aspose.HTML as a Cake Addin
#addin nuget:?package=Aspose.HTML&version=22.5.0

// Install Aspose.HTML as a Cake Tool
#tool nuget:?package=Aspose.HTML&version=22.5.0

Improved XPath Query Processing via HTML .NET API

Version 22.5.0 Nuget


Product Page | Docs | Demos | API Reference | Examples | Blog | Search | Free Support | Temporary License

This .NET HTML API assists developers to write, read, modify, navigate and convert (X)HTML documents from within .NET applications.

Aspose.HTML for .NET API works as a headless browser that allows you to create or open existing HTML documents from various sources in order to perform manipulation operations such as remove and replace HTML nodes, save HTML documents, extract CSS from HTML, configure a document sandbox and more. You may navigate HTML documents by using various methods, such as, element traversal, document traversal, XPath queries, and CSS selector queries as well as manipulate HTML DOM via JavaScript, convert HTML file to images or fixed-layout formats, and convert (X)HTML and EPUB files to other file formats.

It helps you create, modify, extract, copy, delete and replace HTML document content, extract CSS from HTML, configure a document sandbox; load, read, and manage SVG files; render MHTML and EPUB documents to supported output file formats, and perform asynchronous operations.

This library supports parsing of HTML5, CSS3, SVG and HTML Canvas to construct a Document Object Model (DOM) based on the WHATWG DOM Standard. Insert, remove, and edit the nodes. You can navigate HTML documents by using various methods, such as element traversal, document traversal, XPath queries, and CSS selector queries as well as manipulate HTML DOM via JavaScript.

Aspose.HTML for .NET offers comprehensive format conversion support using which your applications can convert from HTML, SVG, EPUB, MHTML, and Markdown to various supported formats. You can also populate an HTML template from XML or JSON data sources. Aspose.HTML can easily work with large and complex HTML-documents.

The classes and properties of Aspose.HTML for .NET API have similar names as that of W3C HTML specification.

HTML Processing API Features

  • Convert HTML to many popular formats including PDF, XPS and images.
  • Load & convert SVG & EPUB to XPS, PDF and images.
  • Navigate through document either by NodeIterator or TreeWalker.
  • Control the timeout of the rendering process.
  • MutationObserver to watch over DOM modifications.
  • Populate HTML document with external data (XML & JSON).
  • Support of single (PDF, XPS) or multiple (image formats) output file streams.
  • Extract CSS styling information.
  • Configuring Sandbox for the environment independent of the execution machine.

What's new in v22.5.0

XPath Query Processing

Improved the processing of the XPath Query. The following C# code sample demonstrates a Web Scrapping, XPath Query usage via API:

// For complete examples and data files, please go to
// Prepare HTML code
var code = @"
    <div class='happy'>
    <p class='happy'>

// Initialize a document based on the prepared code
using (var document = new Aspose.Html.HTMLDocument(code, "."))
    // Here we evaluate the XPath expression where we select all child SPAN elements from elements whose 'class' attribute equals to 'happy':
    var result = document.Evaluate("//*[@class='happy']//span",

    // Iterate over the resulted nodes
    for (Aspose.Html.Dom.Node node; (node = result.IterateNext()) != null;)
        // output: Hello
        // output: World!

Improved handling of Combining Diacritical Marks

Improved the handling of Combining Diacritical Marks Unicode block containing the combining characters for symbols.

Improved CSS Style Parsing

The parsing performance of CSS Styles has been improved.

Improved HTML to PDF Conversion

The HTML to PDF document converter process has been optimized. The representation of Arabic Characters when converting HTML to PDF has also been improved. The following C# code sample demonstrates how HTML can be converted into PDF using API, while configuring various PDF related options (such as, PDF page size and PDF page background color):

// For complete examples and data files, please go to
// Prepare an HTML code and save it to the file
var code = @"<span>Hello</span> <span>World!!</span>";
System.IO.File.WriteAllText("document.html", code);

// Set A5 as a page-size and change the background color to green
var options = new Aspose.Html.Saving.PdfSaveOptions()
    PageSetup =
        AnyPage = new Aspose.Html.Drawing.Page()
            Size = new Aspose.Html.Drawing.Size(Aspose.Html.Drawing.Length.FromInches(8.3f), Aspose.Html.Drawing.Length.FromInches(5.8f))
    BackgroundColor = System.Drawing.Color.Green,
// Convert HTML document to PDF
Aspose.Html.Converters.Converter.ConvertHTML("document.html", options, "output.pdf");

Better Support of Showing SVG in PDF

Previously SVG was not showing up in PDF. This issue has been resolved. The following C# API code sample demonstrates SVG to PDF conversion:

using System.IO;
using Aspose.Html.Converters;
using Aspose.Html.Saving;
     // Invoke the ConvertSVG method for SVG to PDF conversion          
     Converter.ConvertSVG(Path.Combine(DataDir, "shapes.svg"), new PdfSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.pdf"));

For a complete list of features, enhancements, and bug fixes in this release please visit, Aspose.HTML for .NET 22.5 Release Notes.

Read & Write Web Formats

Other: SVG, MD (Markdown)

Save HTML As

Fixed Layout: PDF, XPS

Read Formats


Platform Independence

Aspose.HTML for .NET is written completely in C# and can be used to build any type of 32-bit or 64-bit .NET application including ASP.NET, WCF, WinForms & .NET Core. Development platforms include all flavors of Windows, Linux, and Mac OS X x64 (10.12+).

Getting Started

Are you ready to give Aspose.HTML for .NET a try? Simply execute Install-Package Aspose.Html from Package Manager Console in Visual Studio to fetch the NuGet package. If you already have Aspose.HTML for .NET and want to upgrade the version, please execute Update-Package Aspose.Html to get the latest version.

Convert HTML to GIT-based Markdown (MD) Format

// For complete examples and data files, please go to

// Prepare an HTML code and save it to the file.
var code = "<h1>Header 1</h1>" +
           "<h2>Header 2</h2>" +
           "<p>Hello World!!</p>";
System.IO.File.WriteAllText("document.html", code);

// Call ConvertHTML method to convert HTML to Markdown.
Aspose.Html.Converters.Converter.ConvertHTML("document.html", Aspose.Html.Saving.MarkdownSaveOptions.Git, "");

Product Page | Docs | Demos | API Reference | Examples | Blog | Search | Free Support | Temporary License

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net20 is compatible.  net35 is compatible.  net35-client is compatible.  net40 is compatible.  net40-client is compatible.  net403 was computed.  net45 was computed.  net451 was computed.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Aspose.HTML:

Package Downloads

Aspose.Total for .NET is the most complete package of all .NET file format APIs offered by Aspose. It empowers developers to create, edit, render, print and convert between a wide range of popular document formats within any .NET, C#, ASP.NET and VB.NET applications.


Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
23.5.0 4,457 5/3/2023
23.4.0 5,368 4/4/2023
23.3.0 15,228 3/10/2023
23.2.0 24,589 2/1/2023
23.1.0 18,383 1/20/2023
22.11.0 39,887 11/22/2022
22.10.0 12,500 10/28/2022
22.9.0 14,404 10/1/2022
22.8.0 38,360 8/19/2022
22.7.0 11,248 7/30/2022
22.6.0 13,426 6/28/2022
22.5.0 30,648 5/19/2022
22.4.0 11,279 4/19/2022
22.3.0 126,028 3/7/2022
22.2.0 18,574 2/11/2022
22.1.0 15,391 1/13/2022
21.12.0 9,944 12/8/2021
21.11.0 18,770 11/1/2021
21.10.0 6,874 10/9/2021
21.9.0 24,836 9/2/2021
21.8.0 38,798 8/4/2021
21.7.0 30,391 7/1/2021
21.6.0 8,288 6/9/2021
21.5.0 7,676 5/20/2021
21.4.0 17,239 5/1/2021
21.3.0 22,362 3/10/2021
21.2.0 58,484 2/4/2021
21.1.0 176,176 1/14/2021
20.12.0 14,450 12/4/2020
20.11.0 24,644 11/3/2020
20.9.0 15,155 9/30/2020
20.8.0 14,268 8/31/2020
20.7.0 7,923 7/28/2020
20.6.0 4,303 6/30/2020
20.5.0 28,957 5/20/2020
20.4.0 26,366 4/3/2020
20.3.0 88,607 3/12/2020
20.2.0 9,917 2/9/2020
20.1.0 4,302 1/14/2020
19.12.0 9,835 12/4/2019
19.11.0 5,934 11/11/2019
19.10.0 10,540 10/8/2019
19.9.0 15,603 9/6/2019
19.8.0 6,339 8/7/2019
19.7.0 6,516 7/8/2019
19.6.0 4,195 6/10/2019
19.5.0 10,868 5/9/2019
19.4.0 7,890 4/5/2019
19.3.0 30,047 3/5/2019
19.2.0 3,585 2/6/2019
19.1.0 1,810 1/9/2019
18.12.0 8,379 12/7/2018
18.11.0 9,657 11/6/2018
18.10.0 1,368 10/5/2018
18.9.0 9,889 9/5/2018
18.8.0 1,485 8/7/2018
18.7.0 1,423 7/5/2018
18.6.0 1,396 6/6/2018
18.5.0 3,747 5/2/2018
18.4.0 1,423 4/6/2018
18.3.0 11,758 3/6/2018
18.2.0 2,877 2/7/2018
18.1.0 11,049 1/11/2018
17.12.0 1,164 12/4/2017
17.11.0 1,005 11/9/2017
17.10.0 983 10/9/2017
17.9.0 1,110 9/8/2017
17.8.0 1,114 8/10/2017
17.7.0 7,194 7/14/2017