A template project for a Github page

• to quickly create beautiful slides
• and share them on freely hosted Github pages
• it is based primarily on Markdown → easy collaboration and version control
• you can host multiple presentations
• to see its full power, just check the getting started presentation

It is powered by reveal.js, an awesome project by Hakim El Hattab and based on and inspired by reveal-jekyll by Thomas Friese

Check out the introduction slides to see how to use this repo!

You can set up the project both locally and hosted on Github Pages.

Just fork the project, and rename your main branch to gh-pages.

That's it :)

Clone the project including submodules using

git clone --recursive https://github.com/a-nau/markdownslides.git

The you can either install Jekyll and run it or use the provided Docker image.

We recommend using the Docker image by following these steps:

• Install Docker if you haven't already
• Build the Docker image using docker build -t jekyll .
• Run markdownslides with docker run -v ${PWD}:/app -p 4000:4000 -it --rm --name markdownslides jekyll
• Reach the website under http://localhost:4000/markdownslides/

For more information, also check out this blog post.

Check the examples!

• Jekyll: MIT licensed
• reveal.js: MIT licensed, Copyright (C) 2016 Hakim El Hattab, http://hakim.se
• reveal-jekyll: MIT licensed, Copyright (C) 2016 Thomas Friese, http://tasmo.rocks
• Github CSS Ribbon: MIT licensed, Copyright (c) 2013 Simon Whitaker

Easy Markdown Slides: MIT licensed, Copyright (C) 2021 Alexander Naumann, https://a-nau.github.io