The walkthrough on GitHub worked pretty well to get up and running with Jekyll.

  • Remember that if you want the Jekyll site to live in a folder inside the root of your repo, it must be named docs.
  • Blog post files have to be named in the right format: YEAR-MONTH-DAY-title.MARKUP.
  • Use jekyll serve to run the web server and regenerate the site.

Jekyll also does code snippets:

string player1 = "Crosby";
string player2 = "Malkin";
string player3 = "Guentzel";

// Brute force comparison (equality only)
bool isSamePlayer = player1.Length == player3.Length;
if (isSamePlayer)
{
    for (int i = 0; i < player1.Length; i++)
    {
        if (player1[i] != player3[i])
        {
            isSamePlayer = false;
            break;
        }
    }
}

The Jekyll docs are thorough. Bugs and feature requests can be found at Jekyll’s GitHub repo. Ask questions on Jekyll Talk.