Generate a slideshow using the slides that power the html5-slides presentation
Switch branches/tags
Nothing to show
Pull request Compare This branch is 6 commits ahead, 371 commits behind n1k0:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Generates a slideshow using the slides that power the html5-slides presentation.

A sample slideshow is here.


06/11/10 - Current slideshows will need to be updated. As of tonight's changes (48024cfe), title slides are rendered like any other. This means that you must render them to an h1 element (# or = below). This is cleaner and more consistent.


python and the following modules:

  • jinja2
  • markdown
  • pygments

Markdown Formatting Instructions

  • To create a title slide, render a single h1 element
  • Separate your slides with a horizontal rule (--- in markdown)
  • Your other slides should have a heading that renders to an h1 element
  • To highlight blocks of code, put !{{lang}} as the first indented line
  • See the included for an example

Rendering Instructions

  • Put your markdown content in a file called
  • Run python (or ./
  • Enjoy your newly generated presentation.html


Several options are available using the command line:

$ ./ --help
Usage: [options]

  -h, --help            show this help message and exit
  -s FILE, --source=FILE
                        The path to the markdown source file
  -d FILE, --destination=FILE
                        The path to the to the destination
  -t FILE, --template=FILE
                        The path to the to the Jinja2 template file
  -e ENCODING, --encoding=ENCODING
                        The encoding of your files (defaults to utf8)


  • Test CSS for all Markdown features


  • Nicolas Perriault (n1k0)
  • Vincent Agnano (Particules)
  • Brad Cupit (bradcupit)