If you use Jekyll as a static site generator with GitHub Pages, you benefit from more support with setting up, updating, and troubleshooting your site.

About GitHub Pages and Jekyll

In addition to supporting regular HTML content, GitHub Pages supports Jekyll, a popular static site generator.

About Jekyll themes on GitHub

You can install a Jekyll theme to customize the design of your GitHub Pages site without having to edit or copy CSS files. Jekyll themes package the files you need to change your site design, including any files that are stored in your assets folder, like SCSS, SASS, images, and CoffeeScript.

Adding a Jekyll theme to your GitHub Pages site

You can add a Jekyll theme to your GitHub Pages site by editing your site's _config.yml file.

Adding a Jekyll theme to your GitHub Pages site with the Jekyll Theme Chooser

You can use the Jekyll Theme Chooser to create a GitHub Pages site, or to change the theme of your existing GitHub Pages site.

Customizing CSS and HTML in your Jekyll theme

You can personalize your GitHub Pages site by adding custom styles to your Jekyll theme and changing your theme's layout.

Setting up your GitHub Pages site locally with Jekyll

You can set up a local version of your Jekyll GitHub Pages site to test changes to your site locally. We highly recommend installing Jekyll to preview your site and help troubleshoot failed Jekyll builds.

Configuring Jekyll

You can configure most Jekyll settings by editing your _config.yml file.