Markdown Slides

What is it?

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

How to set up and use it?

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.

Github Pages

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

That's it :)

Locally

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.

What can it do?

Check the examples!

---

Licenses

• 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