Convert SVG to PDF in C#

To convert SVG to PDF in C#, load the SVG with SVGDocument, create PdfSaveOptions, and call Converter.ConvertSVG(). Use ConvertSVG() for straightforward file, stream, or document conversion. Use RenderTo() with PdfDevice when your application needs lower-level rendering control.

Converting SVG documents to other formats is one of the main features of Aspose.SVG for .NET API. Converting is required for various reasons: to work in a familiar, convenient format or to take advantage of different formats for specific tasks. PDF is a file format supported by all operating systems, used for presenting images, documents and books. Files in PDF can be easily viewed, printed, and shared online.

The article provides information on a list of supported SVG to PDF conversion scenarios and how to execute them. You can convert SVG to PDF and other popular formats in any way – online or programmatically. For a broader overview of conversion targets and APIs, see Convert SVG Files in C# and Supported File Formats.

SVG to PDF Conversion Methods

Aspose.SVG for .NET supports two practical SVG to PDF workflows. Choose the API based on how much control your application needs over rendering and output.

Scenario	Recommended API	Why use it
Convert an SVG file, URL, in-memory string, or loaded SVGDocument to PDF	Converter.ConvertSVG() with PdfSaveOptions	Best default choice for concise conversion code and typical server-side workflows. For stream input, load the stream into SVGDocument first.
Render an already configured SVGDocument to a PDF output device	SVGDocument.RenderTo() with PdfDevice and PdfRenderingOptions	Useful when your rendering pipeline already works with devices or needs explicit rendering setup.
Set PDF background, page size, margins, resolution, document information, or encryption	PdfSaveOptions or PdfRenderingOptions	These options control PDF output without changing the source SVG markup.
Convert uploaded SVG content in a web application	SVGDocument(stream, baseUri) plus PdfDevice or Converter.ConvertSVG()	Useful for ASP.NET Core upload workflows where the SVG is received as a stream and the PDF is written to a response stream, cloud storage, or an application-managed output path.

Online SVG Converter

You can check the Aspose.SVG API functionality and convert SVG in real-time. Please load SVG from the local file system, select the output format and run the example. In the example, the save options are set by default. You will immediately receive the result as a separate file.

If you want to convert SVG to PDF programmatically, please see the following C# code examples.

Convert SVG to PDF Using ConvertSVG() Method

The static methods of the Converter class can convert SVG to PDF with a single line of code. It is the easiest way for conversion. Converting an SVG file to another format using ConvertSVG() methods is a sequence of operations among which document loading and saving:

• Load an SVG document using one of the SVGDocument() constructors ( lineto.svg).
• Create an instance of the PdfSaveOptions class.
• Use the ConvertSVG() method to convert and save SVG as a PDF file.

The following code snippet can be used to convert an SVG file to PDF format:

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Converters;
using System.Drawing;
using Aspose.Svg.Saving;

// Convert an SVG file to PDF in C# using ConvertSVG()

// Initialize an SVG document from a file
using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "lineto.svg")))
{
    // Initialize an instance of the PdfSaveOptions class
    PdfSaveOptions saveOptions = new PdfSaveOptions();
    saveOptions.BackgroundColor = System.Drawing.Color.Gray;

    // Convert SVG to PDF
    Converter.ConvertSVG(document, saveOptions, Path.Combine(OutputDir, "lineto_out.pdf"));
}

The PdfSaveOptions() constructor initializes an instance of the PdfSaveOptions class that is passed to ConvertSVG() method. The ConvertSVG() method takes the document, saveOptions, output file path and performs the conversion operation. In the example above, we add the BackgroundColor property that sets Color, which will fill the background of every page.

You can download the complete examples and data files from GitHub. You find out about downloading from GitHub and running examples from the How to Run the Examples section.

Save Options

You can convert SVG to PDF using default or custom save options. PdfSaveOptions or PdfRenderingOptions usage enables you to customize the rendering process; you may specify the page size, margins, background color, file permissions, Css, etc.

Property	Description
JpegQuality	Specifies the quality of JPEG compression for images. The default value is 95.
Css	Gets a CssOptions object which is used for configuration of CSS properties processing.
DocumentInfo	This property contains information about the output PDF document.
BackgroundColor	This property sets the color that will fill the background of every page. By default, this property is Transparent.
PageSetup	This property gets a page setup object and uses it for configuration output page-set.
HorizontalResolution	Sets the horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolution	Sets the vertical resolution for output images in pixels per inch. The default value is 300 dpi.
Encryption	This property gets or sets encryption details. If it is not set, then no encryption will be performed.

Note: The options that are implementing with the PdfSaveOptions class are inheriting from the PdfRenderingOptions class.

Convert SVG to PDF Using RenderTo() Method

Consider SVG to PDF conversion scenario using RenderTo() method:

• Initialize a document using SVGDocument() constructor ( light.svg).
• Initialize an instance of the PdfRenderingOptions class and specify the document’s properties.
• Create a new instance of the PdfDevice class.
• Convert the document by RenderTo() method.

The following code snippet can be used to convert an SVG file to PDF format:

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Drawing;
using Aspose.Svg.Rendering;
using Aspose.Svg.Rendering.Pdf;

// Render SVG to PDF in C# with custom page settings

// Initialize an SVG document from a file
using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "light.svg")))
{
    // Initialize an instance of the PdfRenderingOptions class and set custom PageSetup and JpegQuality properties
    PdfRenderingOptions pdfOptions = new PdfRenderingOptions();
    pdfOptions.PageSetup.AnyPage = new Page(new Drawing.Size(500, 500), new Margin(10, 10, 10, 10));
    pdfOptions.JpegQuality = 10;

    // Initialize an instance of the PdfDevice class
    using (IDevice device = new PdfDevice(pdfOptions, Path.Combine(OutputDir, "light_out.pdf")))
    {
        // Render SVG to PDF, send the document to the rendering device
        document.RenderTo(device);
    }
}

The PdfRenderingOptions() constructor initializes a new object of the PdfRenderingOptions class that is passed as an argument to the PdfDevice(options, file) constructor. The last initializes a new instance of the PdfDevice class by rendering options and output file name. The RenderTo(device) method converts SVG to PDF and sends the current document to the output rendering device.

The JpegQuality specifies the quality of JPEG compression for images. The default is 95. In the example above, the used JpegQuality value is 10. The figure illustrates conversion SVG to PDF for two files light.svg and lineto.svg: a) The JpegQuality value is default; b) The JpegQuality value is 10.

Convert SVGZ to PDF in C#

SVGZ is a GZIP-compressed SVG file. Aspose.SVG for .NET can load SVGZ content with SVGDocument, so you do not need to manually decompress an .svgz file before rendering it to PDF. After loading the SVGZ document, use the same PdfSaveOptions and Converter.ConvertSVG() workflow as for ordinary SVG files:

using Aspose.Svg;
using Aspose.Svg.Converters;
using Aspose.Svg.Saving;

using (var document = new SVGDocument("input.svgz"))
{
    var options = new PdfSaveOptions();
    Converter.ConvertSVG(document, options, "output.pdf");
}

Use this workflow when compressed SVG assets need to become printable documents, reports, or PDF previews. If you need to edit or inspect the markup first, convert the SVGZ file back to an editable SVG document; see Convert SVGZ to SVG in C#.

Practical Recommendations

When you convert SVG to PDF in a production .NET application, keep the source SVG, linked resources, and output requirements under explicit control. SVG documents may reference fonts, CSS files, raster images, or remote resources; make these dependencies available to the rendering process or embed them in the SVG when consistent output is required.

Production task	Recommendation
Convert uploaded SVG files	Load the SVG from a stream or controlled storage location, validate the input, and write the PDF to a stream or application-managed output path. See Create, Load and Read SVG Files in C# for stream loading patterns.
Keep text rendering consistent across Windows, Linux, and containers	Configure or embed the fonts used by the SVG. If a font is unavailable, text may fall back to another font and change layout. See Work with SVG Fonts and Text in C#.
Produce PDF thumbnails, previews, or reports	Set PageSetup, background color, and resolution explicitly so every output file has predictable dimensions. For size-related conversion options, see Resizing a Document During Conversion from SVG.
Process many SVG files	Reuse application configuration, dispose SVGDocument instances, and handle conversion errors per file instead of stopping the entire batch.
Convert untrusted SVG content	Treat SVG as active XML-based content. Validate or sanitize uploaded SVG files and restrict external dependencies according to your application security policy. For resource and runtime settings, see Environment Configuration.

Common Mistakes and Fixes

Problem	Common cause	Fix
PDF page is cropped or has unexpected size	The SVG lacks clear width, height, or viewBox, or the output page setup is not configured	Define the source SVG size or set PageSetup in PdfSaveOptions or PdfRenderingOptions. See SVG viewBox and Resize Document.
Text looks different in the PDF	Required fonts are not available in the runtime environment	Install, configure, or embed the required fonts. See Work with SVG Fonts and Text in C#.
Transparent areas render differently than expected	PDF viewers and downstream tools may display transparency against different backgrounds	Set BackgroundColor when a fixed white, black, or brand-colored background is required. See Change SVG Background Color.
External images or styles are missing	The SVG references files or URLs that are not accessible during conversion	Use valid resource paths, embed required assets, or configure resource access for the conversion environment. See Fix SVG Styling and Font Issues in C#.
Output file is larger than expected	SVG contains large embedded bitmaps or high-quality raster data	Tune JpegQuality, optimize embedded images, or simplify the source SVG before conversion. See Optimizing SVG Files for Web and Performance.

FAQ

When should I use ConvertSVG() instead of RenderTo()?
Use ConvertSVG() for direct conversion tasks. Use RenderTo() when your code already manages rendering devices or needs explicit control through PdfDevice and PdfRenderingOptions.

Can I convert an SVG stream to a PDF stream?
Yes, but use the correct stream workflow. Load the input SVG stream with an SVGDocument constructor, for example SVGDocument(stream, baseUri). For PDF output, render to a stream with PdfDevice, for example new PdfDevice(options, outputStream), or use Converter.ConvertSVG() with an ICreateStreamProvider when your application needs provider-based output.

How can I control PDF page size?
Configure PageSetup in PdfSaveOptions or PdfRenderingOptions. You can also make the SVG dimensions predictable by defining width, height, and viewBox in the source SVG.

Why are fonts different after SVG to PDF conversion?
The conversion process must resolve the fonts used by the SVG. If the original font is unavailable, another font may be substituted. Configure custom fonts or use @font-face where appropriate.

Related Resources

• Convert SVG Files in C# – compare conversion APIs and supported output formats.
• Convert SVG to Images in C# – render SVG to PNG, JPG, WebP, BMP, TIFF, or GIF.
• Convert SVG to XPS in C# – use XPS output when your workflow requires it.
• Convert SVGZ to SVG in C# – decompress SVGZ when you need editable SVG markup before conversion.
• Create, Load and Read SVG Files in C# – load SVG from files, strings, URLs, and streams.
• Save an SVG Document in C# – save SVG files and resources after editing.
• SVG Rendering Quality and Output Consistency – compare rendering results and quality considerations.
• Aspose.SVG.Drawing.SkiaSharp Rendering – use the SkiaSharp-based drawing backend where appropriate.

You can convert SVG to PDF with our free online SVG to PDF Converter that works with high quality, easy and fast. Just upload, convert your files and get results in a few seconds!