Mastering Jekyll

Collection of tutorials to help you master Jekyll, a static site generator built in Ruby.

As developer of some of it’s most popular themes, I’ve become well versed in using Jekyll. Below you’ll find answers to common issues, posts explaining features, tips, tricks, Liquid snippets, and more.

URLs and links in Jekyll

How Jekyll uses URLs and how to link posts, pages, assets, and other resources together.
read more →

Jekyll’s site.url and baseurl

Learn what Jekyll's site url and baseurl variables are and how to properly set them with relative_url and absolute_url filters to avoid broken links and 404 errors.
read more →

Styling language specific code blocks with Jekyll

Interesting styling possibilities with Kramdown syntax highlighted code blocks in Jekyll.
read more →

Accessing static files in Jekyll

Learn how to use static files with Jekyll to create a gallery of images automatically without a plugin.
read more →

Improving Staticman comments on a Jekyll site

How to use Staticman to add threaded comments and reply notifications to a static-based Jekyll site.
read more →

HTML inside Kramdown table cells with Jekyll

The question of how to write a list inside of a table cell with Kramdown recently came up in a thread on Jekyll Talk — prompting me to look…

read more →

Adding comments to a Jekyll site with Staticman

Uninstall Disqus and learn how to add a static-based commenting system to Jekyll with Staticman.
read more →

Building a living style guide with Jekyll

How I used Jekyll to build a living style guide and pattern library for Made Mistakes.
read more →