Files
jekyll/docs/_docs/step-by-step/03-front-matter.md
Mike Neumegen 805f438f24 New docs (#7205)
Merge pull request 7205
2018-09-01 04:39:57 -04:00

948 B

layout, title, position
layout title position
step Front Matter 3

Front matter is a snippet of YAML which sits between two triple-dashed lines at the top of a file. Front matter is used to set variables for the page, for example:

---
my_number: 5
---

Front matter variables are available in Liquid under the page variable. For example to output the variable above you would use:

{% raw %}

{{ page.my_number }}

{% endraw %}

Use front matter

Let's change the <title> on your site to populate using front matter:

{% raw %}

---
title: Home
---
<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
    <title>{{ page.title }}</title>
  </head>
  <body>
    <h1>{{ "Hello World!" | downcase }}</h1>
  </body>
</html>

{% endraw %}

You may still be wondering why you'd output it this way as it takes more source code than raw HTML. In this next step, you'll see why we've been doing this.