---
id: sphinxcontrib-svg2pdfconverter
version: "2.1.0"
license: BSD-2-Clause
license_treatment: permissive
maintenance: active
---

# sphinxcontrib-svg2pdfconverter — Sphinx SVG to PDF or PNG converter extension

License: permissive · Maintenance: active · Downloads: 377.8K/mo

## What it is and what it does

This is a Sphinx extension that solves the problem of SVG image support in documentation builders that don't handle SVG natively—most commonly LaTeX, which is used to generate PDF documentation. When you include SVG images in a Sphinx project targeting a non-SVG-aware builder, this extension automatically converts them to PDF or PNG at build time, ensuring your documentation renders correctly.

The extension offers three pluggable backends for the actual conversion: Inkscape (full-featured but heavier), libRSVG's rsvg-convert (lighter weight), or CairoSVG (the lightest Python-based option). You choose which one to use by selecting the corresponding extension name in your Sphinx conf.py, and the tool must be installed separately on your system. Configuration is minimal—mostly just ensuring the converter binary is in your PATH, with optional tweaks to command-line arguments.

Use it for:

- Generate PDF documentation from Sphinx projects that use SVG diagrams or vector graphics.
- Convert SVG images to PNG for LaTeX-based PDF builds when SVG support is unavailable.
- Automatically handle SVG-to-raster conversion during CI/CD documentation builds without manual pre-processing.
- Use lightweight CairoSVG backend in containerized or resource-constrained build environments.
- Maintain source SVG files in documentation while supporting multiple output formats (PDF, HTML, etc.).

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts SVG images to PDF or PNG for Sphinx documentation builders that don't natively support SVG, using Inkscape, libRSVG, or CairoSVG as the underlying converter.

Yes. This is a stable, actively maintained extension with low install friction and no known vulnerabilities. Install it if you use Sphinx with SVG images and target builders like LaTeX that don't natively support SVG. The main prerequisite—having one of three external converters available—is a reasonable trade-off for automatic image conversion. Choose the backend that fits your environment (Inkscape for full features, rsvg-convert for balance, CairoSVG for minimal dependencies).

## Install

pip install sphinxcontrib-svg2pdfconverter
uv add sphinxcontrib-svg2pdfconverter
poetry add sphinxcontrib-svg2pdfconverter

## Installing sphinxcontrib-svg2pdfconverter

Before you install: Low install friction with a single runtime dependency on Sphinx. Actively maintained as of 2026-03-05 with a stable production status. Requires one of three external system tools (Inkscape, rsvg-convert, or CairoSVG) to function; CairoSVG variant may need additional build dependencies depending on your OS.

License in practice: Licensed under BSD-2-Clause (permissive), allowing use in both open-source and proprietary projects with minimal restrictions.

Quickstart:

pip install sphinxcontrib-svg2pdfconverter

# In conf.py, add one of:
extensions = ['sphinxcontrib.inkscapeconverter']
# or
extensions = ['sphinxcontrib.rsvgconverter']
# or
extensions = ['sphinxcontrib.cairosvgconverter']

Requires one of Inkscape, rsvg-convert (from libRSVG), or CairoSVG installed and available in your system PATH; CairoSVG may require additional OS-level build tools during installation.

Verify before relying:

- Whether all three converter backends (Inkscape, libRSVG, CairoSVG) are equally well-tested and maintained.
- Performance characteristics and output quality differences between the three converter options.
- Compatibility with recent Sphinx versions beyond the stated Python 3.6+ support.

## Package facts

- License: BSD-2-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 377.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sphinx svg to pdf converter, convert svg images latex documentation, sphinx svg png extension, svg to pdf sphinx plugin, inkscape rsvg cairosvg sphinx, sphinx-extension, svg-conversion, documentation-build

[View on SkillFed](https://skillfed.io/packages/sphinxcontrib-svg2pdfconverter) · [View on PyPI](https://pypi.org/project/sphinxcontrib-svg2pdfconverter/)