Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Build leanpub books locally. Watch files and build a new pdf each time they change.

Project Description

Build leanpub books locally from the command line.

Note/Disclaimer: This is not an official Leanpub product, it simply uses pandoc to build a pdf from markdown in a similar way to Leanpub. Currently the output from leanpub is different in style (and this will probably always be the case), however I find that it massively speeds up the iteration process to be able to build a pdf which looks “similar enough” to Leanpub.

This implements a simple cli for building ebooks locally. Rather than having upload your new change-set to Dropbox and then trigger leanpub build on their site - do it all locally.


To build the Book (this requires a Book.txt):

$ leanpub book

To build the Sample (this requires a Sample.txt):

$ leanpub sample

To build both:

$ leanpub all

You can also “watch” for changes in any of the markdown files you are using to build the book i.e. when a markdown file is saved:

$ leanpub watch

You can get help via the command line with:

$ leanpub --help


Install via pip:

$ pip install leanpub

Note: if you don’t have python installed I recommend `miniconda <>`__; no-admin access required.

This requires that pandoc is installed, if it’s not install it here.

Issues / troubleshooting / requests

Please post an issue on github.

Going forward

I would like to improve the output to better match leanpub. Any help it that direction (e.g. css, or prepending the title page) would be great!

Release History

This version
History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(7.0 kB) Copy SHA256 Hash SHA256
Wheel 2.7 Jun 2, 2015
(5.2 kB) Copy SHA256 Hash SHA256
Source None Jun 2, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting