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.
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.