So You Want To Blog

Github Pages

  • Free hosting of your static sites directly from your repository


It takes a template directory containing raw text files in various formats, runs it through a Markdown converter and Liquid template renderer. Then spits out a complete, ready-to-publish static website suitable for serving with your favorite web server. 

  • Simple to use
    • No Database
    • Focus on content
  • Static Templates
    • Markdown
    • Html/CSS

Installation Setup

Log into GitHub and create a new repository named, where username is your username (or organization name) on GitHub. Clone your repo in your workspace.

cd workspace
git clone{username}/{username}
cd {username}

Clone Starter Blog Template into a separate directory and then manually move contents into your {username} directory

git clone

cd into {username} directory and build & run server


Visit Your Blog Page

Push to Github

git add .
git cm "My initial blog commit"
git push origin master

Visit url http://{username}

Emmanuel Apau

Lead Site Reliability Engineer