Article version: Enterprise Server 2.14

This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2019-07-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Configuring Jekyll

GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

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

For more information on configuring your site with Jekyll, see the official Jekyll configuration documentation. For more information about default and optional Jekyll plugins, see "Configuring Jekyll Plugins."

Defaults you can change

The following defaults are set by GitHub Enterprise, which you are free to override in your _config.yml file:

 github: [metadata]
 encoding: UTF-8
 kramdown:
   input: GFM
   hard_wrap: false
 future: true
 jailed: false
 theme: jekyll-theme-primer
 gfm_quirks: paragraph_end

Configuration settings you cannot change

GitHub Pages & Jekyll override the following settings in your _config.yml file, which you cannot change:

lsi: false
safe: true
source: [your repo's top level directory]
incremental: false
highlighter: rouge
gist:
  noscript: false
kramdown:
  math_engine: mathjax
  syntax_highlighter: rouge

Tips:

  • For the content of the repository metadata object, see repository metadata on GitHub Pages.
  • Keep in mind that if you change the source setting, your pages may not build correctly. GitHub Pages only considers source files in the top-level directory of a repository.

Front matter is required

Jekyll requires that Markdown files have front matter defined at the top of every file. Front matter is just a set of metadata, delineated by three dashes:

---
title: This is my title
layout: post
---

Here is my page.

If you like, you can choose to omit front matter from your file, but you'll still need to make the triple-dashes:

---
---

Here is my page.

If your file is within the _posts directory, you can omit the dashes entirely.

For more information on configuring the front matter, see the official Jekyll front matter documentation.

Further reading

Ask a human

Can't find what you're looking for?

Contact us