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 username.github.io, where username is your username on GitHub; i.e. maxjtsai.github.io. ( 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

Authoring

  • 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.

Updates