教程►进阶

Front-matter 高级用法详解

Front-matter 是每篇文章顶部的 YAML 或 JSON 区块，用于定义文章的元数据。掌握 Front-matter 是高效使用 Hexo 的关键。

什么是 Front-matter？

Front-matter 必须位于文章的最顶部，以 --- 开始和结束。例如：

1
2
3
4
5
6
7
8
---
title: 文章标题
date: 2026-07-27 08:00:00
categories:
  - 教程
tags:
  - Hexo
---

常用字段一览

字段 说明 示例
title 文章标题 Hexo 入门指南
date 创建时间 2026-07-27 08:00:00
updated 更新时间 2026-07-28 10:00:00
categories 分类（支持层级） [教程, 进阶]
tags 标签 [Hexo, 前端]
description 文章描述 这是一篇入门文章
keywords SEO 关键词 [Hexo, 博客]
comments 是否开启评论 true / false
layout 使用的布局模板 post / page / 自定义

分类的层级结构

Hexo 的分类支持层级关系，而标签是平级的。

单一层级分类

1
2
categories:
  - 教程

多分类（并列关系）

1
2
3
categories:
  - [教程, 前端]
  - [随笔]

上面的例子表示这篇文章同时属于：

  • 教程 > 前端
  • 随笔

快捷写法

1
categories: [教程, 前端]

这等价于 教程 > 前端 的层级关系。

标签的用法

标签永远是平级的，没有父子关系：

1
2
3
4
tags:
  - Hexo
  - Node.js
  - 静态博客

或者写成一行：

1
tags: [Hexo, Node.js, 静态博客]

文章摘要与 <!-- more -->

Hexo 首页默认显示文章的完整内容。你可以在文章中插入 <!-- more --> 注释来标记摘要的结束位置。

示例：

1
2
3
4
5
这是文章的摘要部分，会显示在首页列表中。

<!-- more -->

这是正文内容，只有在进入文章详情页后才能看到。

自定义模板（Layout）

Hexo 默认有三种布局：

  • post：文章布局（默认）
  • page：独立页面布局
  • draft：草稿布局

你也可以在主题的 layout/ 目录下创建自定义模板，然后通过 layout 字段调用：

1
layout: custom-layout

控制评论显示

如果你使用了评论系统（如 Disqus、Gitalk、Valine），可以通过 comments 字段控制单篇文章是否显示评论区：

1
comments: false

关闭目录（TOC）

部分主题支持通过 Front-matter 控制是否显示文章目录：

1
toc: false

注意：toc 字段是否有效取决于你使用的主题是否支持。

置顶文章

部分主题支持文章置顶功能。常见做法是在 Front-matter 中添加：

1
2
3
top: true
# 或者
sticky: 100

数值越大，排序越靠前。

完整 Front-matter 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
title: 完整的 Front-matter 演示
date: 2026-07-27 08:00:00
updated: 2026-07-29 10:00:00
categories:
  - 教程
tags:
  - Hexo
  - YAML
description: 这是一篇演示 Front-matter 所有用法的文章
keywords: Hexo Front-matter 教程
comments: true
layout: post
toc: true
---

总结

Front-matter 虽然看起来只是文章头部的几行配置，但它决定了文章在站点中的展示方式、组织结构和 SEO 表现。建议你在写作时养成规范填写 Front-matter 的习惯。