写作指南

Hexo 是静态博客生成器，没有传统的后台管理界面，所有内容都是 Markdown 文件，用任何编辑器都能写。这意味着：

• 🗂️ 文章就是文件，不依赖数据库
• ✍️ 用 VS Code / Typora / Obsidian 等任意编辑器
• 🚀 Git 推送即可自动部署

下面介绍完整的写作发布流程。

方法一：Hexo 命令行（推荐）

创建新文章

1

npx hexo new "文章标题"

比如：

1

npx hexo new "我的第一篇博客"

会在 source/_posts/ 下生成 我的第一篇博客.md。

文章格式

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

---
title: 我的第一篇博客
date: 2025-07-03 14:00:00
tags:
  - 随笔
categories:
  - 通用
---

这里开始写正文，支持完整的 Markdown 语法。

## 二级标题

段落内容...

![图片说明](/img/example.png)

`行内代码`

> 引用文字

本地预览

1

npx hexo server

浏览器打开 http://localhost:4000，每次保存文件后刷新页面就能看到效果。

构建发布

1
2
3
4
5

# 清理旧文件
npx hexo clean

# 生成静态文件
npx hexo generate

生成的文件在 public/ 目录。

方法二：直接编辑 Markdown（更简单）

大多数博主更习惯直接用编辑器写：

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

# 1. 用 VS Code 打开项目
code .

# 2. 在 source/_posts/ 下新建 xxx.md

# 3. 在文件顶部写 front matter（标题、日期、标签）

# 4. 开始写正文

# 5. 写完后本地预览
npx hexo server

# 6. 提交到 Git
git add .
git commit -m "新文章：xxx"
git push

Git 推送到 GitHub 后，Cloudflare Pages 会自动构建部署。

文章管理技巧

草稿功能

不想立刻发布？用草稿模式：

1

npx hexo new draft "未完成的文章"

草稿存在 source/_drafts/。预览时加 --draft：

1

npx hexo server --draft

发布草稿：

1

npx hexo publish "未完成的文章"

标签管理

标签用于分类和聚合内容，建议保持一致：

1
2
3
4

tags:
  - 前端
  - React
  - TypeScript

所有标签会显示在 标签页 的标签云中。

分类管理

分类是更大的归类：

1
2
3

categories:
  - 技术
  - 前端

如果写 [技术, 前端]，表示「前端」是「技术」的子分类。

VS Code 推荐插件

总结

没有后台管理，但有更强的灵活性 —— 所有内容都是文件，版本管理、备份、迁移都非常方便。🎉