# Frontmatter
# lang
Type:
stringDetails:
Language for the page.
This will override the
langoption in your site config.Also see:
# title
Type:
stringDetails:
Title for the page.
If you don't specify
titlein frontmatter, content of the first level-one header (i.e.# title) will be used as the title.
# description
Type:
stringDetails:
Description for the page.
This will override the
descriptionoption in your site config.Also see:
# head
Type:
HeadConfig[]Details:
Extra tags in
<head>tag for the page.Example:
head: - - meta - name: foo content: bar - - link - rel: canonical href: foobar1
2
3
4
5
6
7Rendered as:
<head> <meta name="foo" content="bar" /> <link rel="canonical" href="foobar" /> </head>1
2
3
4Also see:
# date
Type:
stringDetails:
Created date for the page.
You should specify the date in the form of
yyyy-MM-dd, or follow the YAML Timestamp Typeopen in new window.
# permalink
Type:
stringDetails:
Permalink for the page.
This will override the default route path that determined by the file path of the page.
Also see:
# permalinkPattern
Type:
stringDetails:
Pattern to generate permalink for the page.
This won't take effect if the
permalinkfrontmatter has been set.Usage:
Pattern Description :yearYear part of created date :monthMonth part of created date :dayDay part of created date :slugSlug of page filename :rawRaw route path The
:year,:monthand:daypatterns are resolved according to the following priority:- The
datefrontmatter. - The filename that matches the date pattern
yyyy-MM-dd-foobar.mdoryyyy-MM-foobar.md. - The dirname that matches the date pattern
yyyy/MM/dd/foobar.mdoryyyy/MM/foobar.md. - Fallback to
1970-01-01.
- The
Example:
Case 1:
The page filename is
foo-bar.md.The page frontmatter is:
--- date: 2021-01-03 permalinkPattern: :year/:month/:day/:slug.html ---1
2
3
4Then the permalink of the page would be
2021/01/03/foo-bar.html.Case 2:
The page filename is
2021-01-03-bar-baz.md.The page frontmatter is:
--- permalinkPattern: :year/:month/:day/:slug.html ---1
2
3Then the permalink of the page would be
2021/01/03/bar-baz.html.
Also see:
# layout
Type:
stringDetails:
Layout for the page.
