rst2reveal is a docutils writer that allows you to write your presentations using rst and convert them to reveal-js with a simple:

python3 input.rst > output.html

Try it on this demo!


rst2reveal supports both regular slides and vertical slides.

Try pressing down!

Vertical slides

rst2reveal supports vertical slides -- just use a different header level in your rst file.

(Only two header levels are supported.)

Keep going down!


  • Lists
  • are
  • supported
  1. Numbered
  2. lists
  3. too

Keep going down!


You can also show snippets of code:

# here's a factorial function in Python 3

def factorial(n):
    """Calculate the factorial recursively"""
    if n == 0:
        return 1
        return n * factorial(n-1)
-- and here's the same in in Haskell

factorial 0 = 1
factorial n = n * fac (n-1)

Keep going down!


Images are supported too:

Great, now go right.


You will need:

  • Python 3
  • docutils
  • reveal-js (rst2reveal will generate only the main html file)

The End

Clone it and improve it!