HTML Converter – Convert HTML in C#

Use the HTML Converter guides when your source is an HTML file, HTML string, stream, or URL. Aspose.HTML for .NET lets C# applications convert HTML to PDF, XPS, DOCX, JPG, PNG, BMP, TIFF, GIF, MHTML, and Markdown.

HTML conversion is the central workflow in Aspose.HTML for .NET because HTML is often the source format for reports, invoices, web pages, archives, and generated content. Most examples in this section use HTMLDocument, a target-specific save options class, and Converter.ConvertHTML().

How HTML Conversion Works

Load HTML from a file, string, stream, or URL with HTMLDocument or a ConvertHTML() overload.
Create save options for the target format, such as PdfSaveOptions, ImageSaveOptions, DocSaveOptions, XpsSaveOptions, MHTMLSaveOptions, or MarkdownSaveOptions.
Call Converter.ConvertHTML() and pass the source, options, and output path or stream provider.

The following example converts an HTML file to PNG with ImageSaveOptions.

 1// Convert HTML to PNG in C#
 2
 3// Prepare a path to a source HTML file
 4string documentPath = Path.Combine(DataDir, "nature.html");
 5
 6// Prepare a path to save the converted file
 7string savePath = Path.Combine(OutputDir, "nature-output.png");
 8
 9// Initialize an HTML document from the file
10using HTMLDocument document = new HTMLDocument(documentPath);
11
12// Create an instance of the ImageSaveOptions class 
13ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Png);
14
15// Convert HTML to PNG
16Converter.ConvertHTML(document, options, savePath);

Example-ConvertHtmlToPng.cs hosted with ❤ by GitHub

For conversion parameters, output streams, and page setup, open the format-specific guides below.

HTML Conversion Guides

HTML to fixed-layout documents

Convert HTML to PDF – create PDF output with default or custom PdfSaveOptions.
Convert HTML to XPS – render HTML to XPS with XpsSaveOptions.

HTML to Word and web archive formats

Convert HTML to DOCX – save HTML as a Word document with DocSaveOptions.
Convert HTML to MHTML – package HTML and resources into a single MHTML archive.
Convert HTML to Markdown – transform HTML content into Markdown text.

HTML to image formats

Convert HTML to JPG – render HTML to JPEG images.
Convert HTML to PNG – render HTML to PNG images.
Convert HTML to BMP – render HTML to BMP images.
Convert HTML to GIF – render HTML to GIF images.
Convert HTML to TIFF – render HTML to TIFF images.
HTML to Image in .NET on Linux – configure Docker fonts when Linux image output differs from local rendering.

Related Conversion Controls

Fine-Tuning Converters – adjust page setup, margins, resolution, image quality, background color, and rendering devices.
Output Stream Providers – write conversion output through custom streams.

Other Platforms

Try Online HTML Conversion

Use the online HTML Converter for quick file checks. Use Aspose.HTML for .NET when HTML conversion must be automated in C# code.

Converting Between Formats Convert HTML to PDF