frontmatter

Overview ¶

Package frontmatter extracts the metadata stored in your files. This metadata can include any information you want, but typically contains the page title, creation date, tags, layout template, and more. There are no requirements about what fields must be present; this is entirely up to you.

+++
Title = "My homepage"
Tags = ["best", "page", "ever"]
+++

Metadata in YAML format is enclosed by three minus (-) characters:

---
Title: "My homepage"
Tags:
  - "best"
  - "page"
  - "ever"
---

Metadata in JSON format is enclosed by brace characters ({ and }):

{
    "Title": "My homepage",
    "Tags": ["best", "page", "ever"]
}

It is possible to enclose the frontmatter starting and ending delimiters in HTML comments. The comment has to start and stop on the same line as the delimiter.

<!-- ---
Title: "My homepage"
Tags:
  - "best"
  - "page"
  - "ever"
--- -->

Normal page content immediately follows the metadata section. The metadata section is stripped after processed by this plugin.