Front Matter

Learn how to use frontmatter in Hexo blog posts (as intended for use in this theme).

Front Matter

Front matter is the metadata section of Hexo blog posts and pages, usually located at the beginning of the Markdown file. It uses YAML format to define properties of the post or page, such as title, date, type, comments, etc.

Example

In Post

In Page

Featured Page

---
title:
date:
type:
comment:
cover:
katex:
reprint:
locate:
---

Front Matter Properties

General Properties

Property	Type	Description
title	`string`	Required Page/article title
date	`datetime`	Required Page/article creation date
type	`string`	Required* Required for pages with type values and banner setup
updated	`datetime`	Optional Page/article update date
desc	`string`	Optional Page/article description
aside	`boolean`	Optional Enable sidebar (default true)
comment	`boolean`	Optional Show comments module (default true)
cover	`string`	Optional Article cover image URL (requires `type` for Banner images)
reprint	`boolean`	Optional Copyright (default original); true for reprint
katex	`boolean`	Optional Enable katex (default false)
locate	`string`	Optional Article creation location
container	`boolean`	Optional Enable container (for hexo-solitude-tag, default: true)

Special Properties

Only effective when type: banner or other pages with type values

Property	Type	Description
leftend	`string`	Optional Banner bottom left text
rightend	`string`	Optional Banner bottom right text
rightbtn	`string`	Optional Banner bottom right button text
rightbtnlink	`string`	Optional Banner bottom right button link

Edit this page

Advanced Configuration

Learn how to configure advanced settings for the Solitude theme.

Tags Plugin

Learn how to use the theme's Tags plugin to easily write blog posts.

On This Page

Front Matter
- Example
- Front Matter Properties

Star on GitHub Create Issues