GitShow - Create presentations from Markdown sources

GitShow generates a Reveal.js presentation from a set of plain markdown files. It allows to maintain the presentation sources separately (e.g. in a git repository) and to automatically generate a static reveal.js bundle or a PDF file from them without installing a new copy of reveal.js for each presentation. See demo presentations for a few examples of presentation sources.

GitShow provides a pre-configured (but still configurable) Reveal.js environment where the author can focus on creating mardown files (which can even be done directly on GitHub). It also allows the use of built-in or custom templates that define the visual style of the presentation. Knowledge of HTML, CSS, JavaScript and other related technologies is not required, but very helpful.

In addition, the gitshow-view application allows to instantly display the presentations shared in a public GitHub repository.

Requirements

GitShow requires node.js and npm installed (e.g. from NodeSource).

Installation

Install the command line tool:

npm install -g @burgetr/gitshow

Usage

Create a new presentation:

mkdir my-presentation
cd my-presentation
gitshow init

The presentation.json file now contains the presentation configuration. Edit the configuration and markdown files to add some content to the presentation. See the reveal.js documentation for information on how to use markdown in the presentation.

Get a live preview of the presentation by running

gitshow serve

and visiting http://localhost:8000 with your web browser. The presentation is automatically updated when the source files change.

The PDF version of the presentation can be created using

gitshow pdf

A ZIP package containing a static, web-ready HTML presentation can be created using

gitshow package