Convert SVG to PDF in Python

Use SVGDocument to load an SVG file, create PdfSaveOptions, and call Converter.convert_svg(document, options, output_path) to save SVG as PDF. Use PdfSaveOptions to set page sizing, background color, resolution, JPEG quality, metadata, or encryption when the default output is not enough.

Aspose.SVG APIs Used

API	Purpose
SVGDocument	Loads the source SVG document
Converter.convert_svg()	Converts SVG to PDF, XPS, or image formats
PdfSaveOptions	Configures PDF output for converter-based workflows
PdfRenderingOptions	Configures PDF output for rendering-device workflows
PdfDevice	Receives rendered SVG content and writes a PDF file

Convert SVG to PDF Programmatically

PDF is a common output format when SVG graphics must be printed, archived, attached to documents, or shared in a format that preserves layout across viewers. Aspose.SVG for Python via .NET lets you convert SVG to PDF with a high-level converter API or with a rendering device when you need explicit control over the rendering pipeline.

Use Converter.convert_svg() for most file conversion tasks. Use SVGDocument.render_to() with PdfDevice when your workflow already uses rendering devices or needs a device-based rendering pattern.

Before running the examples, install Aspose.SVG for Python via .NET in your Python environment.

Convert SVG to PDF Using Converter.convert_svg()

The simplest way to convert SVG to PDF is to load the SVG document, create PdfSaveOptions, and call Converter.convert_svg().

from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.saving import PdfSaveOptions

# Convert an SVG file to PDF using the default save options
options = PdfSaveOptions()

with SVGDocument("document.svg") as document:
    Converter.convert_svg(document, options, "document.pdf")

Convert SVG to PDF with Custom Save Options

Use PdfSaveOptions when you need to control PDF output. The following example sets a transparent background, fits the page to the SVG content, changes raster image resolution, and adjusts JPEG quality.

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.drawing import Resolution
from aspose.svg.rendering import SizingType
from aspose.svg.saving import PdfSaveOptions
from aspose.pydrawing import Color

# Convert SVG to PDF and customize page sizing and image quality
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "document.svg")
output_path = os.path.join(output_folder, "document.pdf")
os.makedirs(output_folder, exist_ok=True)

options = PdfSaveOptions()
options.background_color = Color.from_argb(0, 255, 255, 255)
options.page_setup.sizing = SizingType.FIT_CONTENT
options.horizontal_resolution = Resolution.from_dots_per_inch(96.0)
options.vertical_resolution = Resolution.from_dots_per_inch(96.0)
options.jpeg_quality = 80

with SVGDocument(input_path) as document:
    Converter.convert_svg(document, options, output_path)

Common PdfSaveOptions Properties

Property	What it controls
background_color	Page background color when the SVG has transparent areas
page_setup	Output page size, margins, and sizing mode
horizontal_resolution	Horizontal resolution for rasterized resources inside the PDF
vertical_resolution	Vertical resolution for rasterized resources inside the PDF
jpeg_quality	JPEG compression quality for embedded raster images
document_info	PDF metadata such as title, author, subject, and keywords
encryption	PDF encryption and permission settings

PdfSaveOptions inherits PDF rendering settings from PdfRenderingOptions, so many output properties are shared between converter-based and device-based workflows.

Convert SVG to PDF Using render_to()

The render_to() method sends the loaded SVG document to a rendering device. This pattern is useful when your application already works with Aspose.SVG rendering devices or needs to choose the target device explicitly.

import os
from aspose.svg import SVGDocument
from aspose.svg.rendering import SizingType
from aspose.svg.rendering.pdf import PdfDevice, PdfRenderingOptions

# Render SVG to PDF through a PdfDevice
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "document.svg")
output_path = os.path.join(output_folder, "document.pdf")
os.makedirs(output_folder, exist_ok=True)

options = PdfRenderingOptions()
options.jpeg_quality = 80
options.page_setup.sizing = SizingType.FIT_CONTENT

with SVGDocument(input_path) as document:
    with PdfDevice(options, output_path) as device:
        document.render_to(device)

Converter.convert_svg() vs render_to()

Method	Best for
Converter.convert_svg()	Direct SVG-to-PDF conversion with concise code and save options
SVGDocument.render_to()	Rendering workflows that use output devices such as PdfDevice

For ordinary SVG to PDF conversion, start with Converter.convert_svg(). It is shorter and maps naturally to file conversion tasks. Use render_to() when you need the rendering-device pattern.

Common Mistakes and Fixes

Problem	Likely cause	Fix
The PDF page size is not what you expected	Default page setup does not match the SVG viewport or content bounds	Set options.page_setup.sizing and configure page size or margins explicitly
Transparent SVG areas appear with an unwanted background	The PDF viewer or output workflow applies its own background	Set options.background_color to the required color before conversion
Embedded images look blurry or too large	Resolution and JPEG quality settings do not match the output target	Adjust horizontal_resolution, vertical_resolution, and jpeg_quality
Output PDF is not created	The target folder does not exist or the script saves to another working directory	Create the output folder with os.makedirs() and build paths with os.path.join()
Text or external resources are missing	The SVG references fonts, images, or CSS files that cannot be resolved	Use correct file paths and keep external resources available relative to the SVG document

Online SVG to PDF Converter

You can test SVG to PDF conversion with the free online SVG to PDF Converter. Upload an SVG file, run the conversion, and compare the result before implementing the same workflow in Python.

FAQ

How do I convert SVG to PDF in Python?

Load the SVG with SVGDocument, create PdfSaveOptions, and call Converter.convert_svg(document, options, output_path).

Can I set the PDF page size during SVG conversion?

Yes. Use the page_setup property of PdfSaveOptions or PdfRenderingOptions to configure the page size, margins, and sizing mode.

Can I convert SVG to PDF without using the Converter class?

Yes. Create PdfRenderingOptions, open a PdfDevice, and call document.render_to(device).

Does SVG to PDF conversion preserve transparency?

Transparent SVG content can be preserved, but the visible result depends on the PDF viewer and workflow. Set background_color if you need a predictable page background.

How can I reduce the size of the generated PDF?

Lower jpeg_quality, reduce embedded raster image resolution, and simplify large or complex SVG content before conversion.

Related Articles

• Convert SVG to PNG in Python explains raster conversion and image save options.
• Convert SVG to Image in Python covers SVG conversion to JPG, BMP, TIFF, GIF, and other raster formats.
• Convert SVG Files in Python gives an overview of all supported SVG conversion formats.
• Create SVG File shows how to create SVG documents or load SVG from files, strings, and URLs before conversion.
• Edit SVG File explains how to modify SVG elements before saving or converting the document.
• Save SVG File explains how to save SVG documents after creating or editing them.
• Navigate SVG shows how to inspect SVG elements with CSS selectors and XPath before conversion.
• Supported File Formats lists input and output formats supported by Aspose.SVG for Python via .NET.
• Licensing explains how to apply a license or request a temporary license for full conversion results.