一、Hexo 页面内容填充分类清单（按页面类型划分）

所有页面均通过 hexo new page 页面名 命令创建（生成 source/页面名/index.md），后续按类型填充内容即可。

补充：页面内容填充通用步骤

1. 执行 hexo new page 页面名 创建页面，生成 source/页面名/index.md；
2. 编辑 index.md 中的 Front-matter（--- 之间），配置标题、横幅图等基础信息；
3. 按对应页面类型填充正文内容（手动编写/依赖文章配置）；
4. 执行 hexo clean && hexo g && hexo s 本地预览，确认内容无误后部署。

二、Hexo 文章写作语法（Markdown 基础 + Hexo 专属标签插件）

Hexo 文章（_posts 目录下 .md 文件）支持「标准 Markdown 语法」和「Hexo 专属标签插件」，前者用于基础排版，后者用于实现复杂功能（如音乐、折叠、友链等）。

第一部分：标准 Markdown 基础语法（必掌握）

适用于所有文章/静态页面，语法简洁，兼容性强。

1. 标题（分级标题，最多 6 级）

1
2
3
4
5
6

# 一级标题（对应页面大标题，推荐一篇文章一个）
## 二级标题（对应文章小节标题）
### 三级标题（对应小节下的子标题）
#### 四级标题
##### 五级标题
###### 六级标题（最小级别，不推荐过多使用）

效果：标题字号逐级减小，自动换行，Butterfly 主题会自动美化样式。

避坑：# 与标题文字之间必须加空格，否则会被识别为普通文本。

2. 段落与换行

• 段落：直接输入文本，段落之间留一个空行即可实现分段；
• 强制换行：文本末尾加 2 个空格，再按回车（或使用 <br> 标签）。

1
2
3
4

这是第一段内容，直接输入即可。

这是第二段内容，与第一段之间留了一个空行（实现分段）。
这是第二行内容，末尾加了两个空格（实现强制换行）<br>这是第三行内容，使用了 br 标签强制换行。

3. 文本格式（加粗、斜体、删除线等）

1
2
3
4
5
6

**加粗文本**（推荐使用两个 `*`，也可使用两个 `_`）
*斜体文本*（推荐使用一个 `*`，也可使用一个 `_`）
***加粗+斜体文本***（三个 `*` 包裹）
~~删除线文本~~（两个 `~` 包裹）
<u>下划线文本</u>（HTML 标签，Markdown 无原生下划线语法）
`行内代码`（单个反引号包裹，用于展示小段代码、命令）

效果：加粗文本、斜体文本、加粗+斜体文本、删除线文本、下划线文本、npm install hexo。

4. 列表（无序列表、有序列表、嵌套列表）

• 无序列表：使用 -、+、* 开头，后面加空格；
• 有序列表：使用「数字+.」开头，后面加空格；
• 嵌套列表：子列表前缩进 2 个或 4 个空格（与父列表对齐）。

1
2
3
4
5
6
7
8
9
10
11
12
13

# 无序列表
- 列表项 1
- 列表项 2
  - 嵌套子列表项 1
  - 嵌套子列表项 2
+ 列表项 3（与 - 效果一致）

# 有序列表
1. 第一步：执行 hexo clean
2. 第二步：执行 hexo g
3. 第三步：执行 hexo s
   1. 嵌套子步骤 1
   2. 嵌套子步骤 2

5. 链接（普通链接、图片链接）

• 普通链接：两种写法，推荐「超链接文本+链接」格式，更易阅读；
• 图片链接：在普通链接前加 !，支持设置图片Alt文本（图片加载失败时显示）。

1
2
3
4
5
6
7
8

# 普通链接
[Hexo 官方文档](https://hexo.io/zh-cn/docs/)（推荐，格式：[超链接文本](链接地址)）
<https://hexo.io/zh-cn/docs/>（简化写法，直接展示链接）

# 图片链接
![Image](42f2e3e4-1e16-403f-a498-7859bbbfa60c?width=1920&height=1080)）
![Image](8835683f-2562-4ac5-b59f-3be572bcd901?width=1920&height=1080)（带悬浮提示的写法）
[![Image](63c3d44d-ab19-46cb-8008-501e66468bcf)（图片+跳转链接，点击图片打开对应网址）

避坑：图片/链接 URL 必须能直接访问，推荐使用图床存储图片，避免本地路径（./img/xxx.jpg）部署后失效。

6. 表格

用于展示结构化数据（如电影清单、友链列表），语法：| 分隔列，- 分隔表头和内容。

1
2
3
4

| 文章标题 | 发布时间 | 分类 |
|----------|----------|------|
| Hexo 博客搭建指南 | 2026-01-19 | 编程技术 |
| Butterfly 主题配置 | 2026-01-20 | 博客美化 |

补充：可调整表格对齐方式（: 控制）：

1
2
3

| 左对齐 | 居中对齐 | 右对齐 |
|:------ |:-------: |:------:|
| 内容 1 | 内容 2 | 内容 3 |

7. 引用（blockquote）

用于引用名人名言、外部文章内容，使用 > 开头。

1
2
3
4

> 不是每个人都应该像我这样去建造一座水晶大教堂，但是每个人都应该拥有自己的梦想。——罗伯·舒乐
> 
> 嵌套引用：
> > 这是二级引用，在 `>` 前再加一个 `>`

8. 代码块（多行代码，支持语法高亮）

用于展示完整代码片段，使用 3 个反引号 ``` 包裹，可指定编程语言（实现语法高亮）。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

```javascript
// JavaScript 代码示例
function helloHexo() {
  console.log("Hello, Hexo!");
}
helloHexo();
# Python 代码示例
print("Hello, Hexo!")
**避坑**：代码块前后的 3 个反引号需单独占一行，指定编程语言时无需加空格。

#### 9. 分割线
用于分隔文章内容，使用 3 个及以上 `-`、`*`、`_`，单独占一行。
```markdown
这是分割线上方的内容

---（推荐使用，简洁）
***
___

这是分割线下方的内容

第二部分：Hexo 专属标签插件（适配 Butterfly 主题，进阶功能）

标签插件是 Hexo 扩展语法，用 {% 插件名 %} 包裹，可实现 Markdown 原生不支持的功能，Butterfly 主题已内置大部分常用插件。

1. 音乐播放器

适配网易云、QQ 音乐、酷狗等平台，需先在主题 _config.yml 开启 aplayerInject。

2. 折叠面板

用于隐藏大段内容（如详细代码、文章附录），点击展开。

3. 友链卡片

用于友链页排版，美化友链展示效果，需先在 source/link/index.md 中配置。

4. 图片标注

给图片添加说明文字，美化图片展示效果。

5. 隐藏指定内容

隐藏敏感内容或需要付费/登录才能查看的内容（Butterfly 主题专属）。

第三部分：文章写作通用规范（避坑+优化）

1. 文章文件命名：推荐使用「YYYY-MM-DD-文章标题.md」格式（如 2026-01-19-Hexo写作语法.md），避免中文特殊字符；
2. Front-matter 必配项：title（文章标题）、date（发布时间）、tags（标签）、categories（分类），语法严格，冒号后加空格；
3. 图片优化：所有图片使用图床存储（如 ImgDB、阿里云 OSS），避免本地路径，图片尺寸建议压缩至 2M 以内，提升页面加载速度；
4. 代码规范：代码块指定编程语言，添加注释，避免大段无格式代码；
5. 生效流程：文章写作完成后，必须执行 hexo clean && hexo g 才能生成静态文件，本地预览无误后再执行 hexo d 部署。

总结

1. 页面内容填充：「标签/分类页」依赖文章配置，「关于/友链页」依赖手动编写，归档/首页由 Hexo 自动生成；
2. 文章写作：基础排版用 Markdown 语法，进阶功能用 Hexo 标签插件，适配 Butterfly 主题可实现更多美化效果；
3. 核心避坑：遵循 YAML 语法（Front-matter）、使用网络 URL 存储图片、配置变更后执行清理/生成命令。

这份清单可直接收藏备用，后续遇到页面配置或文章写作问题，可快速查阅对应内容。