HTML-to-PDF rendering supports the following PNG formats, including interlaced images:

Color typeBit depths
Greyscale1, 2, 4, 8, 16
RGB8, 16
Indexed palette1, 2, 4, 8
Greyscale with alpha8, 16
RGBA8, 16

PNG color and transparency retain their full precision in the PDF, including 16-bit samples. Animated PNGs render their default image only. Color-profile conversion is unsupported.

JPEG images

The renderer embeds supported 8-bit baseline and progressive JPEGs. Grayscale, RGB, YCbCr, CMYK, Adobe CMYK and Adobe YCCK retain their supported color conventions. Malformed segments, inconsistent color metadata, empty scans and truncated streams return diagnostics. Structural validation does not fully decode JPEG pixels; PDF viewers decode the embedded image.

SVG images

SVGs appear as PNG artwork in the PDF. SVG text is rasterized and links inside an SVG are inactive. Wrap the image in an HTML anchor to make it clickable. The renderer uses up to svg_raster_scale samples per CSS pixel, reducing that extra density when needed to fit the per-image raster and decoding limits. Density changes preserve natural image dimensions. Source, conversion and aggregate resource limits still apply.

Provide images and fonts through the supported asset sources. The converter cannot read arbitrary files or fetch network resources. DTD/entity declarations and escaped CSS resource syntax are rejected.

foreignObject, non-scaling strokes and SVG2 inline textPath path data return a diagnostic. Use a same-document path reference for supported text paths.

Morphology and convolution filters have a configurable work budget. Expensive filters and filter combinations whose work cannot be bounded return :resource_limit_exceeded before conversion. Reduce raster dimensions, filter radius, kernel size or reuse.

SVG conversion uses Resvg and can differ from browser rendering, particularly for gradients, filters, masks, markers and text paths. Check complex artwork against the output you need. See diagnostics for conversion failures and HTML and CSS support for image sizing and styling.