Revealjs + Markdown

Reveal.js (@gitgub) is a open-source (MIT-Licensed) HTML-Framework for easily creating beautiful presentations using HTML —according to there website. It has a nice live demo too.

I’m going to use it with markdown however…

Revealjs and its documentation assumes you speak fluently html, javascript, and are willing to read the code to understand the features. Or, use the (non open-source) online editor. That does not fit to my wishes …

However there is an option to use markdown! It comes standard with a plugin to handle several dialects [1] of markdown [2]. And although md [1] is not rst, it is text-based. And so easy to maintain. Apparently, one can even put in html-comments into the md-text, to set the “features”.

Speaking about features: They are hardly documented, but nice. One can specify slide-traditions, animate “fragments” [3], and probably a lot more. So, let try and collect all information!


We try to stay as close to sphinx as possible. So: no html nor javascript, except in templates. We allow md, and where possible we use the syntax that is similar to rst [4]. Probably we have to allow the html-style features. And we will introduce “next slide” pseudo-directives.

Each “presentation” will consist of 2 files: a html-template [5] and the md-content. Due implementation details of revealjs, this only works when a web-server is used. A slight drawback, but we can live with it.





comments powered by Disqus