Convert HTML to PNG in Python

To convert HTML to PNG in Python, call Converter.convert_html() with an HTML source, ImageSaveOptions, and an output path. The source can be an HTML file, an HTMLDocument, inline HTML with a base URI, or a webpage URL supported by the selected overload.

PNG uses lossless compression and supports transparency. It avoids the compression artifacts associated with lossy formats, making it suitable for webpage captures, diagrams, interface previews, text, and line graphics. Aspose.HTML for Python via .NET renders the HTML and CSS before writing the result as one or more PNG images.

Convert HTML to PNG – Python Example

The basic workflow uses a local HTML file and the default PNG save settings:

1. Specify the source HTML file.
2. Create an ImageSaveOptions object. PNG is the default image format.
3. Call Converter.convert_html() with the source, options, and output PNG path.

# Convert HTML to PNG in Python

import aspose.html.converters as conv
import aspose.html.saving as sav

# Convert HTML to PNG
conv.Converter.convert_html("document.html", sav.ImageSaveOptions(), "output.png")

This overload reads document.html, applies the default image settings, and writes output.png.

Convert a Webpage URL to PNG in Python

Use a Url object to render an online HTML page as PNG:

1. Create a Url object for the webpage.
2. Create ImageSaveOptions and specify an output path.
3. Pass the URL, options, and output path to Converter.convert_html().

import os
import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.saving as sav

output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

url = ah.Url("https://docs.aspose.com/html/files/aspose.html")
output_path = os.path.join(output_dir, "aspose-from-url.png")

options = sav.ImageSaveOptions()
conv.Converter.convert_html(url, options, output_path)

The application must have network access to the page and its linked resources. This example uses a static sample HTML file; a complex website can take longer to process while external resources are loaded.

Convert HTML to PNG Using ImageSaveOptions

Use ImageSaveOptions to select PNG output and configure the page layout, resolution, and antialiasing:

1. Load the HTML source into an HTMLDocument.
2. Create ImageSaveOptions for PNG.
3. Configure the required page and rendering settings.
4. Convert the document and save the PNG output.

import os
import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.drawing as dr
import aspose.html.rendering.image as rim
import aspose.html.saving as sav

input_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

input_path = os.path.join(input_dir, "banner.html")
output_path = os.path.join(output_dir, "banner-options-resolution.png")

with ah.HTMLDocument(input_path) as document:
    options = sav.ImageSaveOptions(rim.ImageFormat.PNG)
    options.page_setup.any_page.size = dr.Size(
        dr.Length.from_millimeters(210.0),
        dr.Length.from_millimeters(297.0)
    )
    options.horizontal_resolution = dr.Resolution.from_dots_per_inch(200.0)
    options.vertical_resolution = dr.Resolution.from_dots_per_inch(200.0)
    options.use_antialiasing = True
    conv.Converter.convert_html(document, options, output_path)

The example converts banner.html, explicitly selects PNG, sets an A4 page and 200 dpi resolution, and enables antialiasing. The source HTML uses a viewport-dependent flex layout with height: 100vh. When the output page is set to A4, the layout is recalculated for the A4 page instead of the browser window. As a result, the banner width and text wrapping differ from the browser view. The 200 dpi setting determines the raster dimensions and produces a 1654 × 2339 pixel PNG. The illustration below shows a cropped preview of the rendered A4 page:

Control PNG Dimensions, Transparency, and Sharpness

PNG uses lossless compression, so it preserves text, line graphics, and interface details without JPEG-style compression artifacts. The visible result still depends on the rendered pixel dimensions, fonts, CSS layout, and source images.

• Set page_setup.any_page.size in pixels when exact PNG dimensions are required.
• Keep the default transparent background, or set background_color when the PNG requires a solid page background.
• Use source images with sufficient pixel dimensions. Increasing the output size cannot restore detail missing from a low-resolution source image.
• Keep antialiasing enabled and test text hinting when small rasterized text needs adjustment.

For shared page, resolution, CSS, and rasterization settings, see Configure Image Output with ImageSaveOptions.

Common HTML to PNG Conversion Issues

Problem	Check or fix
Transparency is not visible	Check whether the HTML or CSS defines a background color. background_color is transparent by default, but a document background is still rendered.
Text or images look blurred	Increase the actual pixel dimensions and use sufficiently detailed source images. PNG compression itself is lossless.
The PNG is larger than expected	Reduce the page dimensions or simplify large raster resources. Lossless PNG output can be larger than JPEG for photographic content.

For pagination, page sizing, missing resources, and URL-loading problems, see Common HTML to Image Conversion Issues.

Related HTML Conversion Guides

• HTML Converter – choose another HTML output format.
• Convert HTML to Image – compare raster formats and configure shared image settings.
• Convert HTML to JPEG – create a smaller lossy image when transparency is not required.
• Convert HTML to GIF – convert HTML content to GIF output.
• Fine-Tuning Converters – compare direct conversion with renderer and device-based workflows.
• Rendering Options – configure image rendering with device-based APIs.

Other Platforms

• Convert HTML to PNG in .NET
• Convert HTML to Image in Java

FAQ

Can I convert an HTML string to PNG?

Yes. Use the Converter.convert_html() overload that accepts the HTML string, a base URI, ImageSaveOptions, and an output path. The base URI is required when the string contains relative resource URLs.

Does HTML to PNG conversion preserve transparency?

PNG supports transparency, and the default background_color is transparent. A background defined by the HTML or CSS is still rendered. Set background_color explicitly when the output requires a solid page background.

Can I convert HTML to PNG for free?

Use the free online HTML to PNG Converter below for occasional manual conversions. For programmatic conversion, you can evaluate the library without a license or follow the licensing guide to request a temporary license.

Try Online HTML to PNG Conversion

Use the free online HTML to PNG Converter for quick manual conversion without writing code. Use Aspose.HTML for Python via .NET when HTML-to-PNG conversion must run in a Python application, service, or document-processing workflow.