Markdown web slides served cold.
JavaScript HTML Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Markdown web slides served cold

Freeze and thaw Markdown to HTML with Remark and (Frozen) Flask and serve via GitHub pages.

Do-it-yourself example

Create an empty repository on GitHub e.g. called "example".

Create an empty directory with the same name as the repository ("example") and in this directory copy-paste the following to a file called

# Title slide

## Your Name

Your affiliation


layout: false

## Second slide

- Hey
- Ho
- Lets
- Go


## Third slide

- Example equation (with MathJax): $$ a^2 + b^2 = c^2 $$

After that follow these steps:

git init
git add
echo "venv/" > .gitignore
git add .gitignore
virtualenv venv
source venv/bin/activate
pip install Flask
pip install Frozen-Flask
git submodule add refreeze
python refreeze/ # serve via
python refreeze/    # create static html
git add index.html           # deploy html to github pages
git commit -m "initial commit"

Now create a gh-pages branch and push the branch to GitHub (adapt username and repository name):

git checkout -b gh-pages
git remote add origin
git push -u origin gh-pages

Few minutes later marvel at Yay!

Serving images

If you want to use images, put them under img/ and reference them like this:

![]({{ base }}/img/picture.jpg)

The directory does not have to be called img. The placeholder {{ base }} is replaced by

You can resize images like this:

<img src="{{ base }}/img/figure.gif" style="width: 400px;"/>