Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


This is a script that can export Keynote presentations in formats that are better for sharing them as standalone documents. Natively,

  • Keynote will export slides with presenter notes as a PDF. But the resulting formatting is terrible, giving 50% of each page of the PDF up to the notes.
  • Keynote will export an HTML document, but it won't include presenter notes with it.

This script addresses both of these issues.

  • It generates a nicely-formatted PDF like this one, suitable for uploading to Speakerdeck or others.
  • It generates an html presentation in a minimalist, reader-friendly format inspired by Maciej Cegłowski.

Examples and Screenshots

Here is an example of the HTML site generated.

You also get PDF presentation slides that look like this:

A nice looking slide

Instead of the crappy ones that Keynote gives you:

A horrible looking slide

A full PDF sample can be found here.


pyenv virtualenv is a reasonable way to have isolated python environments. Follow their instructions for setting that up and then do this:

$ pyenv virtualenv 3.6.1 better-keynote-export
$ pyenv activate better-keynote-export
$ pip install -r requirements.txt


Use ./ --help to see all of the available options. Basically,

./ \
  --keynote=<the keynote file> \
  --outdir=<a path> \
  --title=<the name of the presentation> \
  --twitter-username=<your twitter username>

The output path gets both a PDF file and a self-contained website that you can easily host with (for example) GitHub pages.


You must have Keynote installed to use this.

Fundamentally, this works by scripting Keynote using Applescript. The details of this helpfully change from Keynote version to version. So if the script isn't working, it might be that I haven't updated it recently and minor tweaks are needed for the latest version of Keynote. Pull requests welcome!


A better export for sharing Keynote presentations, with support for presenter notes.



No releases published
You can’t perform that action at this time.