Hexo 博客写作指南

写在前面

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


一、每篇文章的开头

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

1
2
3
4
5
6
7
8
9
10
11
12
13
---
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 # 文章封面图(可选)
---

快速新建文章的命令:

1
hexo new post "文章标题"

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


二、正文排版

Hexo 支持标准 Markdown 语法,以下是常用语法示例:

2.1 标题

1
2
3
4
# 一级标题(通常用于文章主标题,正文中从二级标题开始)
## 二级标题
### 三级标题
#### 四级标题

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 基础代码块

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

1
2
3
4
5
6
7
8
9
```go
package main

import "fmt"

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

渲染效果:

1
2
3
4
5
6
7
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 写完怎么预览?

1
2
3
4
5
# 启动本地服务器
hexo server

# 或者简写
hexo s

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

4.2 写完怎么部署?

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 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 --> 标记,标记之前的内容会作为摘要显示在首页列表:

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

5.2 草稿文章

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

本地预览时想看草稿:

1
hexo s --draft

发布草稿:

1
hexo publish draft "草稿标题"

5.3 置顶文章

在 front-matter 中加 sticky: 1(数字越大越靠前):

1
2
3
4
---
title: 置顶文章
sticky: 1
---

5.4 隐藏文章

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

1
2
3
4
---
title: 隐藏文章
hide: true
---

六、写文章的建议

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

七、参考资料

Hello World

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1
$ hexo new "My New Post"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment