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 the Jekyll Theme Chooser

You can use GitHub's Jekyll Theme Chooser to quickly create a Jekyll site.

Creating a GitHub Pages site with the Jekyll Theme Chooser

You can create a GitHub Pages site with the Jekyll Theme Chooser using a new or existing site repository.

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.

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.