Hexo 教程

编写格式

type 属性

在题头部分,type 属性有特殊作用,一般会被识别成特定的页面,比如使用 hexo new page tags 的时候,就会在 source 下生成一个 tags 目录和一个 index.md 文件,此时只需要在 index.md 页面的题头部分编写 type: tags 的话,那么该页面就会对所有文章的标签进行汇总和整理,对应 menu 的 /tags 页面。

---
title: tags
date: 2025-11-28 15:30:11
type: tags
---

categoreis 也是如此

categories 和 tags

一般在文章的题头部分,会编写文章的相关信息,比如编写日期、作者、分类、标签之类,那么应该如何写呢?

tags 的写法比较简单,有两种:

# 方式一,使用 yaml 的列表形式
tags:
- t1
- t2

# 方式二,使用 js 的数组形式(比较直观,更推荐这种)
tags: [t1, t2]

categories 有三种:

# 1. 单分类,文章会被归类到 c1 这个类别
categories: c1

# 2. 嵌套分类(两种写法),文章会被归类到 c1/c2 这个类别中,相当于一个大类别中的小类别
categories: [c1, c2]
categories:
- c1
- c2

# 3. 多标签分类,文章会被同时归类到 c1、c2 和 c/c3 的类别中
categories:
- [c1]
- [c2]
- [c, c3]

Hexo 插件

存在图片 404 的问题?可以按照如下步骤解决:

  1. _config.yaml 中,将 post_asset_folder 设置为 true
  2. 安装 npm install hexo-image-link --save 依赖
  3. 确保图片所在的位置在与文档同级的同名目录下:./${filename}/xxx.png