Skip to main content

Allows the generation of the PDF version of your MkDocs documentation.

Project description

MkPDFs for MkDocs Build Status

It's a MkDocs plugin that export your documentation in a single PDF file

MkPDFs for MkDocs

The MkPDFs plugin will export yor documentation in your MkDocs repository as a PDF file using WeasyPrint.

Unlike other plugin where customizing the design of the generated PDF is complicated, this plugin brings the ability to completely control the design of the generated PDF.

What makes this plugin particular, is that:

  1. Your documentation is exported as a single PDF file
  2. The order of pages fits the navigation as defined in the MkDocs configuration file
  3. The ability to override the default design to make it fit your needs
  4. The ability to exclude some files from the generated PDF
  5. No layout issues
  6. No conflict with the theme design
  7. Table of contents integrated in the PDF


  1. This package requires MkDocs version 1.0
  2. Python 3.4 or higher
  3. WeasyPrint depends on cairo, Pango and GDK-PixBuf which need to be installed separately. Please follow your platform installation instructions carefully:


The PDF version of the documentation will not be created if the used generated page content's is not enclosed in an <article> tag or in a <div> tag with property role="main".


Install the package with pip:

pip3 install mkpdfs-mkdocs

Enable the plugin in your mkdocs.yml as folowing

    - search
    - mkpdfs

or with options

    - search
    - mkpdfs:
        - company: The War Company Inc.
        - author: Monsieur Silvestre

Note: If you enable this plugin and you don't have plugins entry in your MkDocs config file yet, you will need to explicitly enable the search plugin. This plugin is enabled by default when no plugins entry is set.

You can find further information about plugins in the MkDocs documentation.

How does it work?

When building or serving your documentation with mkdocs build or mkdocs serve, the following message will be displayed if everything wend smoothly:

The PDF version of the documentation has been generated.


This plugin supports following options to allow you better handle the customisation of the generated PDF.

Option Description
author The author of the document. This information will be printed on the cover page of the generated PDF.
company If this documentation is from a company, then you should provide this information. It will be displayed on the front page of the documentation, bellow the author information
toc_title The table of content title. The default value is Table of Contents
toc_position The position of the table of contents. This option supports 3 differents values: pre to put the toc at the beginning of the file but after the cover (*the default value), post to put it at the end of the file or none to not generate it at all.
output_path The file name of the generated PDF, relative to the site_dir. By default this location is set to pdf/combined.pdf
design Relative to your MkDocs repository, this option is the location of the CSS file defining the layout of the generated PDF. If this option is not defined the default design will be used. Defining an non existing file will cause the build or serve failure.


From reporting a bug to submitting a pull request, every contribution is appreciated and welcome. Report bugs, ask questions and request features using Github issues.

Thanks to

The idea of this plugin has raised while working on a project in the public sector. After many research I found some plugins that guided me to the current solution. They have inspired me a lot, so many thanks to:

Project details

Download files

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

Files for mkpdfs-mkdocs, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size mkpdfs-mkdocs-1.0.1.tar.gz (1.8 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page