Front-matter

Front-matter 是位於檔案開頭的 YAML 或 JSON 區塊，用於設定您的文章。當使用 YAML 撰寫時，Front-matter 以三個破折號終止；當使用 JSON 撰寫時，則以三個分號終止。

YAML

---
title: Hello World
date: 2013/7/13 20:46:25
---

JSON

"title": "Hello World",
"date": "2013/7/13 20:46:25"
;;;

設定及其預設值

設定	描述	預設值
layout	佈局	config.default_layout
title	標題	檔案名稱（僅限文章）
date	發佈日期	檔案建立日期
updated	更新日期	檔案更新日期
comments	為文章啟用留言功能	true
tags	標籤（頁面不適用）
categories	分類（頁面不適用）
permalink	覆寫文章的預設永久連結。永久連結應以 / 或 .html 結尾	null
excerpt	純文字的頁面摘要。使用此外掛格式化文字
disableNunjucks	啟用時，停用 Nunjucks 標籤 {{ }}/{% %} 和標籤外掛的渲染	false
lang	設定語言以覆寫自動偵測	繼承自 _config.yml
published	文章是否應該發佈	對於 _posts 下的文章，為 true，對於 _draft 下的文章，為 false

佈局

預設佈局為 post，與 default_layout 設定在 _config.yml 中的值一致。當文章中的佈局被停用（layout: false）時，將不會使用主題進行處理。但是，它仍然會被任何可用的渲染器渲染：如果一篇文章是用 Markdown 撰寫的，並且安裝了 Markdown 渲染器（例如預設的 hexo-renderer-marked），它將會被渲染為 HTML。

標籤外掛總是會被處理，無論佈局如何，除非被 disableNunjucks 設定或 渲染器停用。

分類與標籤

只有文章支援使用分類和標籤。分類依順序應用於文章，產生分類和子分類的層次結構。標籤都在相同的層次結構級別上定義，因此它們出現的順序並不重要。

範例

categories:
  - Sports
  - Baseball
tags:
  - Injury
  - Fight
  - Shocking

如果您想要應用多個分類層次結構，請使用名稱列表而不是單一名稱。如果 Hexo 在文章中看到以這種方式定義的任何分類，它會將該文章的每個分類視為其獨立的層次結構。

範例

categories:
  - [Sports, Baseball]
  - [MLB, American League, Boston Red Sox]
  - [MLB, American League, New York Yankees]
  - Rivalries