Hexo 文章 Front-matter 注意事项 + 模板

Hexo 文章 Front-matter 注意事项及完整开头模板

一、核心注意事项（避坑必备，严格遵循）

1. 语法格式基础（YAML 语法，不可违规）

  • 必须用 --- 首尾包裹，缺一不可（开头和结尾各一行 ---，单独占行）。
  • 所有配置项的「冒号后必须加 1 个英文空格」（如 title: 文章标题 正确，title:文章标题 错误）。
  • 禁止使用全角字符（如全角冒号 ：、全角空格 　），全部使用半角字符（英文标点、英文空格）。
  • 配置项顺序无强制要求，但建议按「标题→时间→分类→标签→其他」排序，便于阅读和维护。

2. 分类（categories）配置注意

  • 多个分类/二级分类，优先使用「数组 - 格式」（推荐），- 后必须加 1 个空格，且保持统一缩进（2 个或 4 个空格，推荐 2 个）。
  • 禁止直接用英文逗号分隔多个分类（如 categories: 编程开发,Linux 错误），会被识别为单个分类。
  • 分类名大小写敏感（如 Linux 和 linux 是两个不同分类），禁止包含 ,、#、& 等特殊字符。
  • 二级分类需嵌套缩进（在一级分类下换行，缩进后加 - 配置），不可平级排列。

3. 标签（tags）配置注意

  • 语法要求与分类完全一致，优先使用「数组 - 格式」，禁止直接用英文逗号分隔。
  • 标签是「碎片化标记」，可多可少（建议 3-5 个），无需层级，平级排列即可。
  • 标签名尽量精准简洁（如 Linux 配置文件 优于 很多Linux上的配置文件），避免冗余。

4. 其他关键注意

  • date 配置的时间格式推荐 YYYY-MM-DD HH:mm:ss，可自定义（如 2026-01-19 20:30:00），不填则默认取文件创建时间。
  • 文章标题（title）避免过长（建议不超过 20 字），禁止包含 *、?、/ 等特殊字符，防止生成静态页面路径错误。
  • 可选配置项（如 comments、top_img）按需添加，语法格式与核心配置项一致。

二、完整开头模板（3 种场景，直接复用）

模板 1：基础通用版（所有文章均可使用，推荐）

适用于大部分普通文章，包含核心必配项，语法规范，无冗余配置。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
# 必配核心项（缺一不可，按此格式填写）
title: 50个Linux上重要的配置文件
date: 2026-01-19 20:30:00
categories:
  - 编程开发
  - Linux
tags:
  - 编程开发
  - Linux
  - 系统配置
  - 运维技巧
---

# 文章正文（从此处开始写作，使用 Markdown 语法）
## 一、前言
Linux 系统的配置文件是管理和优化系统的核心，本文整理了 50 个常用且重要的配置文件，帮助大家快速掌握系统配置要点...

模板 2：带二级分类版（精准归类，适合技术类文章）

适用于需要更细致层级分类的文章，突出分类的层级关系，便于后续汇总查阅。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
title: 50个Linux上重要的配置文件
date: 2026-01-19 20:30:00
categories:
  - 编程开发
    - Linux 运维  # 二级分类，嵌套缩进（与上一级 - 对齐，缩进 2 个空格）
tags:
  - Linux
  - 配置文件
  - 系统优化
  - 后端开发
---

# 文章正文
## 一、前言
Linux 系统的配置文件是管理和优化系统的核心，本文整理了 50 个常用且重要的配置文件，帮助大家快速掌握系统配置要点...

模板 3：简化单行数组版（少量分类/标签，追求简洁）

适用于分类和标签数量较少（各 2 个以内）的文章，保持单行格式，简洁明了。

1
2
3
4
5
6
7
8
9
10
---
title: 50个Linux上重要的配置文件
date: 2026-01-19 20:30:00
categories: [编程开发, Linux]  # 单行数组格式，逗号后加空格更美观
tags: [Linux, 配置文件]
---

# 文章正文
## 一、前言
Linux 系统的配置文件是管理和优化系统的核心，本文整理了 50 个常用且重要的配置文件，帮助大家快速掌握系统配置要点...

三、额外补充：可选配置项扩展模板（进阶美化）

若需优化文章展示效果（适配 Butterfly 主题），可添加以下可选配置项，直接整合到上述模板中即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
title: 50个Linux上重要的配置文件
date: 2026-01-19 20:30:00
categories:
  - 编程开发
  - Linux
tags:
  - Linux
  - 配置文件
  - 系统优化
# 可选配置项（按需添加，无需可删除）
comments: false  # 关闭文章评论功能（默认开启，如需关闭设为 false）
top_img: https://pic1.imgdb.cn/item/696cead8e8f4cc17ae682caa.jpg  # 文章顶部横幅图
cover: https://pic1.imgdb.cn/item/696cead8e8f4cc17ae682caa.jpg  # 文章封面图（首页展示）
published: true  # 设为 true 发布文章，设为 false 保存为草稿（不生成静态页面）
---

总结

  1. 注意事项核心：遵循 YAML 语法，分类/标签优先用数组 - 格式，禁止直接逗号分隔。
  2. 模板可直接复制复用，只需修改「标题、时间、分类、标签」和正文内容，无需调整格式。
  3. 后续写作时，建议固定使用一种模板格式（推荐模板 1），保持博客文章风格统一，减少解析报错。