Front Matter

Front matter allows page-specific metadata and functionality to be included at the top of a Markdown file.

In the documentation and the example site, we will predominantly use YAML to format the front matter of content files and TOML to format the configuration files. This is because TOML is more human-friendly but popular Markdown editors primarily support YAML front matter in content files.

Edit your content on the go or from the comfort of your sofa with the integrated open source Wowchemy CMS and the built-in GitHub editor for editing site settings.

Edit your content locally on your computer with the integrated open source Wowchemy CMS and a Markdown editor for editing site settings.

If a content file has front matter variables set between triple-minus --- lines, then it is YAML formatted. Otherwise, a content file will have variables set between triple-plus +++ lines, indicating that it is TOML formatted.

The front matter may include metadata such as page title, date published, author, categories, tags, and so on. Here is a simple YAML front matter example:

date: 2017-12-01
title: My first blog post

If you wish to convert between formats, a handy online YAML<–>TOML converter is available.