Convert HTML to PNG in C#

To convert HTML to PNG in C#, use Converter.ConvertHTML() with an HTML source, ImageSaveOptions, and an output path. ImageSaveOptions lets you control the image format, page setup, background color, resolution, CSS media type, and rendering quality.

This guide shows the core HTML to PNG workflows for C# applications: a one-line conversion, a file-based conversion, custom image rendering options, and output stream providers. Before running the examples, install and configure Aspose.HTML for .NET in your project. The complete C# example project is available in the Aspose.HTML for .NET GitHub repository.

PNG is a lossless image format widely used for screenshots, documentation assets, UI previews, and web publishing. Use HTML to PNG conversion when your application needs to render a web page, generated HTML, or template output into a raster image with predictable layout and visual quality.

Convert HTML to PNG with One Line of C#

For simple input, the static Converter class provides a short path from HTML content to a PNG image. The example below passes HTML code, a base URI, default ImageSaveOptions, and the output file path to ConvertHTML().

// Convert HTML to PNG using C#

// Invoke the ConvertHTML() method to convert HTML to PNG
Converter.ConvertHTML(@"<h1>Convert HTML to PNG!</h1>", ".", new ImageSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.png"));

Use this pattern when your HTML is already available as a string and default PNG rendering settings are enough. For file input, page setup, resolution, or custom output streams, use the workflows below.

Convert an HTML File to PNG in C#

A typical file-based conversion uses an HTMLDocument instance, an ImageSaveOptions object, and Converter.ConvertHTML(). By default, ImageSaveOptions uses PNG as the output image format.

The workflow is:

1. Load the HTML file with an HTMLDocument constructor.
2. Create an ImageSaveOptions instance.
3. Call Converter.ConvertHTML(document, options, savePath) to render the HTML document as a PNG image.

The following C# code converts an HTML document to PNG.

// Convert HTML to PNG in C#

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "nature.html");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "nature-output.png");

// Initialize an HTML document from the file
using HTMLDocument document = new HTMLDocument(documentPath);

// Create an instance of the ImageSaveOptions class 
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Png);

// Convert HTML to PNG
Converter.ConvertHTML(document, options, savePath);

When to Use HTML to PNG Conversion

Use PNG output when the rendered HTML page must keep sharp text, line art, UI details, or a transparent background. PNG is a strong choice for documentation screenshots, diagrams, code-heavy pages, and lossless previews. If smaller photographic thumbnails are more important than crisp edges, HTML to JPG may be a better fit. If the output must remain a document, use HTML to PDF.

PNG is the default ImageSaveOptions.Format value, so a plain ImageSaveOptions instance already targets PNG output. You can still adjust page setup, background color, resolution, antialiasing, and stream-based output.

Customize HTML to PNG with ImageSaveOptions

Use ImageSaveOptions when the output image needs custom rendering settings. The same options class is used for PNG, JPG, BMP, GIF, and TIFF output; for PNG, the default Format value is ImageFormat.Png.

Option	Use it to control
Format	Output image format, such as PNG, JPG, BMP, GIF, or TIFF. The default value is ImageFormat.Png.
PageSetup	Output page size and margins used during rendering.
BackgroundColor	Background fill color. The default value is transparent.
HorizontalResolution	Horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolution	Vertical resolution for output images in pixels per inch. The default value is 300 dpi.
UseAntialiasing	Rendering quality for shapes, text, and images. Antialiasing is enabled by default.
CSS	CSS media type and related CSS processing options.
Text	Text rendering options for image output.

The following example creates a PNG file with custom image save options.

// Convert HTML to PNG in C# with custom settings

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "nature.html");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "nature-output-options.png");

// Initialize an HTML document from the file
using HTMLDocument document = new HTMLDocument(documentPath);

// Initialize ImageSaveOptions
ImageSaveOptions options = new ImageSaveOptions()
{
    UseAntialiasing = false,
    HorizontalResolution = 100,
    VerticalResolution = 100,
    BackgroundColor = System.Drawing.Color.Beige
};

// Convert HTML to PNG
Converter.ConvertHTML(document, options, savePath);

In this example, ImageSaveOptions is passed to Converter.ConvertHTML() together with the loaded HTML document and output path. The sample configures background color, horizontal and vertical resolution, and antialiasing behavior.

Use UseAntialiasing = true when visual smoothness is more important than rendering speed. Use UseAntialiasing = false for simpler, performance-oriented rendering where sharper edges or faster processing are acceptable.

Save HTML to PNG with an Output Stream Provider

Image formats can produce multiple output files, especially when rendered content spans more than one page. If your application needs to save generated PNG files to custom storage, such as memory, a database, cloud storage, or an archive, implement ICreateStreamProvider.

The ICreateStreamProvider interface lets your code create a stream at the beginning of document or page rendering and release it after rendering is complete.

The example below implements a custom MemoryStreamProvider.

// Implement a custom MemoryStream provider for advanced control over HTML rendering output streams

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (MemoryStream stream in Streams)
            stream.Dispose();
    }
}

The following C# code uses MemoryStreamProvider during HTML to PNG conversion and then saves the generated stream content to a file.

// Convert HTML to PNG in C# using memory stream

// Create an instance of MemoryStreamProvider
using MemoryStreamProvider streamProvider = new MemoryStreamProvider();

// Initialize an HTML document
using HTMLDocument document = new HTMLDocument(@"<h1>Convert HTML to PNG File Format!</h1>", ".");

// Convert HTML to JPG using the MemoryStreamProvider
Converter.ConvertHTML(document, new ImageSaveOptions(ImageFormat.Png), streamProvider);

// Get access to the memory stream that contains the result data
MemoryStream memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.png")))
{
    memory.CopyTo(fs);
}

Related Image Workflows

• Convert HTML to JPG – render HTML to JPEG output.
• Convert HTML to BMP – save rendered HTML as a BMP image.
• Convert HTML to GIF – render HTML content to GIF.
• Convert HTML to TIFF – create TIFF output from HTML.
• Linux Docker Fonts for HTML to Image – configure fonts for image rendering in Linux containers.

Related HTML Conversion Guides

• Convert HTML to PDF – create PDF output with PdfSaveOptions.
• Convert HTML to DOCX – save HTML as a Word document with DocSaveOptions.
• Convert HTML to XPS – render HTML to XPS output.
• Convert HTML to MHTML – package HTML and resources into one archive file.
• Convert HTML to Markdown – transform HTML content into Markdown.

Other Platforms

• Convert HTML to PNG in Java
• Convert HTML to PNG in Python via .NET

Try Online HTML to PNG Conversion

Use the online HTML to PNG Converter for quick manual conversion. Use Aspose.HTML for .NET when HTML to PNG rendering must run inside a C# application, service, reporting tool, or image-generation workflow.