Mastering Jekyll

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

As developer of some 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.

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.

Styling language specific code blocks with Jekyll

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

Accessing static files in Jekyll

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

Improving Staticman comments on a Jekyll site

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

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 for a solution.

Adding comments to a Jekyll site with Staticman

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

Building a living style guide with Jekyll

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