Hexo 博客写作指南

写在前面

这篇文章是博客的第一篇教程文章，同时也是一份写作指南。以后写文章不知道怎么排版、怎么写 front-matter，直接参考这篇就行。

---

一、每篇文章的开头

每篇文章的开头都有一段 front-matter，用三个短横线 --- 包裹，格式是 YAML：

---
title: 文章标题
date: 2026-05-25 12:00:00    # 发布时间
updated: 2026-05-26 10:00:00 # 更新时间（可选）
categories:                   # 分类，可以有多个层级
  - 教程
  - Hexo
tags:                         # 标签，可以有多个
  - 博客
  - Markdown
description: 文章摘要，用于 SEO 和列表页展示
cover: /images/article-cover.jpg  # 文章封面图（可选）
---

快速新建文章的命令：

hexo new post "文章标题"

这会在 source/_posts/ 目录下自动创建一个 .md 文件，并带上模板中的 front-matter。

---

二、正文排版

Hexo 支持标准 Markdown 语法，以下是常用语法示例：

2.1 标题

# 一级标题（通常用于文章主标题，正文中从二级标题开始）
## 二级标题
### 三级标题
#### 四级标题

2.2 文本格式

这是一段加粗的文字，这是斜体，这是删除线，这是行内代码 console.log("hello")。

2.3 有序/无序列表

无序列表：

• 第一项
• 第二项
  • 子项 A
  • 子项 B

有序列表：

1. 第一步
2. 第二步
3. 第三步

2.4 引用

这是一段引用文字。
可以多行。

甚至可以嵌套。

2.5 链接和图片

GitHub

2.6 表格

列名 1	列名 2	列名 3
数据 A	数据 B	数据 C
数据 D	数据 E	数据 F

---

三、代码块

这是技术博客最常用的功能。

3.1 基础代码块

用三个反引号包裹，后面跟上语言名称：

```go
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}
```

渲染效果：

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

3.2 支持的常见语言

python, javascript, bash, yaml, go, rust, java, c, cpp, sql, json, dockerfile, kubernetes, hcl 等。

---

四、写作工作流

4.1 写完怎么预览？

# 启动本地服务器
hexo server

# 或者简写
hexo s

启动后访问 http://localhost:4000 即可实时预览，保存文件后自动刷新。

4.2 写完怎么部署？

# 1. 清理缓存
hexo clean

# 2. 生成静态文件
hexo generate

# 或者简写
hexo g

# 3. 部署到 GitHub Pages
hexo deploy

# 或者简写
hexo d

# 一键执行
hexo clean && hexo generate && hexo deploy

4.3 推荐写作顺序

1. hexo new post "标题" → 创建文章
2. 在编辑器中打开生成的 .md 文件
3. 填写 front-matter（标题、分类、标签）
4. 写正文，保存
5. hexo s 本地预览
6. 满意后 hexo d 部署上线

---

五、常用小技巧

5.1 文章摘要

在文章中插入 <!-- more --> 标记，标记之前的内容会作为摘要显示在首页列表：

这里是文章开头，会在首页摘要中显示。
<!-- more -->
这里是正文，首页摘要看不到。

5.2 草稿文章

不想发布的文章用 hexo new draft "草稿标题" 创建，存放在 source/_drafts/ 目录。

本地预览时想看草稿：

hexo s --draft

发布草稿：

hexo publish draft "草稿标题"

5.3 置顶文章

在 front-matter 中加 sticky: 1（数字越大越靠前）：

---
title: 置顶文章
sticky: 1
---

5.4 隐藏文章

不想在首页列表显示但在导航/归档中能看到：

---
title: 隐藏文章
hide: true
---

---

六、写文章的建议

1. 分类要少而精：分类是树状结构，建议不超过 5 个主分类。比如：教程、笔记、分享、折腾
2. 标签可以多一些：标签是扁平的，用来标记技术关键词。比如 Kubernetes、Docker、Go、Linux
3. 写好 title 和 description：影响搜索引擎收录
4. 文章配图：放在 source/images/ 目录下，正文用 /images/xxx.jpg 引用
5. 定期发布：保持更新频率比一篇长文更有价值

---

七、参考资料

• Hexo 官方文档
• Markdown 语法指南
• Icarus 主题文档