Skip to main content

Convert reStructured Text to PDF via ReportLab.

Project description

rst2pdf: Use a text editor. Make a PDF.

The usual way of creating PDF from reStructuredText is by going through LaTeX. This tool provides an alternative by producing PDF directly using the ReportLab library.

More information is available at the main website


  • User-defined page layout. Multiple frames per page, multiple layouts per document.

  • Page transitions

  • Cascading stylesheet mechanism, define only what you want changed.

  • Supports TTF and Type1 font embedding.

  • Any number of paragraph styles using the class directive.

  • Any number of character styles using text roles.

  • Custom page sizes and margins.

  • Syntax highlighter for many languages, using Pygments.

  • Supports embedding almost any kind of raster or vector images.

  • Supports hyphenation and kerning (using wordaxe).

  • Full user’s manual


Install from PyPI

The latest released version may be installed from PyPI by using pip. It supports Python 2.7 or 3.6+:

$ pip install --user rst2pdf

Install from Snap

If you are using a system that supports snaps then you can install from there with:

$ snap install rst2pdf

Install from GitHub

Work on rst2pdf has restarted on GitHub, with the goals of supporting Python 3, addressing outstanding issues, and not breaking anything. You can clone the repository and install this version:

$ git clone rst2pdf
$ cd rst2pdf
$ git checkout <desired-branch> # if you want something other than master
$ pip install --user .

You may want to install it in a virtualenv, but that is beyond the scope of this readme.


To convert a restructuredText document to a PDF, simply run:

$ rst2pdf <document name> output.pdf

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rst2pdf-0.97rc1.tar.gz (140.1 kB view hashes)

Uploaded Source

Built Distribution

rst2pdf-0.97rc1-py3-none-any.whl (165.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page