Macana

YAML frontmatter

This page lists supported YAML frontmatter fields.

name

  • Type: string

Name of the document. This appears the final URL path and affects links.

For example, if a file named /Foo.md has below frontmatter,

---
name: "Bar"
---

# Baz

the final URL would be like http://localhost:8080/Bar/. You should avoid reaching to this field.

title

  • Type: string

Title of the document. By default, file name is used as a title.

description

  • Type: description

Description text of the document.

lang

  • Type: string
  • Alias: language
  • Example: en-US, ja, zh-Hans

Language of the document. This field value goes to HTML's lang tag, hence you should use language tag adheres to RFC 5646 - Tags for Identifying Languages.

createdAt

  • Type: string (datetime)
  • Example: 2020-01-01T08:30:00+05:00

Creation time of the document. While you can use various date time format for this field, you should stick to Date Time String Format defined in ECMAScript (YYYY-MM-DDTHH:mm:ss.sssZ).

updatedAt

  • Type: string (datetime)
  • Example: 2020-01-01T08:30:00+05:00

Update time of the document. While you can use various date time format for this field, you should stick to Date Time String Format defined in ECMAScript (YYYY-MM-DDTHH:mm:ss.sssZ).

defaultDocument

  • Type: boolean

Whether this document is the default document of a generated website. If more than one documents have this field set on, behavior is undefined.