Free hosting with GitHub Pages
GitHub Pages are powered by Jekyll, so you can easily deploy your site using GitHub for free—custom domain name and all.

Getting Stated

  • Of course, head over to Github and get your account if you do not have one.
  • Create a new repository named, where username is your username on GitHub; i.e. ( note: the first part of the repository has to be exactly match the username; otherwise, it won’t work! )
  • Clone your Github repository via command-line (via terminal) or desktop tools.
  • To make it easy for Blogging, I set up Jekyll and add a theme.
  • Authoring content with your preferred IDE
  • More details at Pages at Github


  • It is Markdown: kramdown. Here is the Quick Reference.
  • Brackets is a modern, Open Source text editor that understands web design and it has a Markdown Preview plug-in.
  • You can modify the theme-style by editing main.scss. Here is my example (theme: minima): .site-header { background-color: black; }

      .site-title, .site-title:visited {
          color: lightgray;
      .site-nav .page-link {
          color: lightcyan;
          border-right: 1px solid gray;
          padding: 3px;
      @media screen and (max-width: 600px) {
        .site-nav .page-link {
          color: #000;

Custom Domain

  1. Create a CNAME record
  2. Go to your repository > Settings > Custom Domain and enter the fully qualified domain name. note: I believe it creates a CNAME file under your repository and do not change it – I might be wrong.