Skip to content
Use a text editor. Make a PDF.
Python Makefile Batchfile Shell
Branch: master
Clone or download
Pull request Compare This branch is 4 commits ahead, 435 commits behind rst2pdf:master.
Roberto Alsina
Roberto Alsina erm
Latest commit 51f004f Nov 8, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Spelling fixes in manual May 23, 2018
gui Make exception handlers be py3-like Apr 27, 2018
rst2pdf not used Nov 7, 2018
.travis.yml Update hash for test_fancytitles Dec 24, 2017
CHANGES.rst Update CHANGES.rst May 6, 2018
Contributors.txt Remove trailing whitespace & ensure unix line endings Nov 1, 2017 Focus issue template on bug reporting Aug 27, 2018
LICENSE.txt updated copyright info May 20, 2009
README.rst Reorder README to show features first Jul 4, 2015 Create a pinned version of requirements.txt Nov 15, 2017
requirements.txt erm Nov 7, 2018
setup.cfg Possible solution for rst2pdf#84. The version is now set in only 1 pl… Jan 23, 2009 Use new URL Nov 7, 2018



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

Installation and use

Install from PyPI

The latest released version, 0.93, may be installed from PyPI by using pip or easy_install. It does not support Python 3:

sudo pip 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 my_clone_name
cd my_clone_name
git checkout <desired-branch> # if you want something other than master
sudo python install

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:

rst2pdf <document name> output.pdf
You can’t perform that action at this time.