博客文章写作规范与模板

为什么需要统一模板？#

每次写文章都要回忆 frontmatter 怎么写、分类和标签怎么填、日期格式对不对。统一一个模板，复制粘贴就行。

文章模板#

1
---
2
title: "文章标题"
3
date: 2026-01-01T00:00:00+08:00
4
draft: false
5
categories: ["技术笔记"]
6
tags: ["标签1", "标签2"]
7
description: "文章摘要，显示在列表页"
8
---
9

10
# 文章标题
11

12
正文从这里开始……

各字段说明#

分类规范#

目前博客的分类：

• 技术笔记 — 编程、部署、工具使用等技术相关内容
• 生活随笔 — 日常生活、感想、非技术内容

标签规范#

标签比分类更细粒度，一个文章可以有多个标签：

• 技术相关：Hugo、Next.js、React、部署、踩坑、前端、后端
• 生活相关：生活、北京、随笔

标签不要太多，2-5 个为宜。

文件命名规范#

• 用英文小写 + 连字符：my-new-post.md
• 不要用中文文件名
• 文件放在 content/posts/ 目录下

发布流程#

1
# 1. 创建新文章（复制模板）
2
cp content/posts/template.md content/posts/my-new-post.md
3

4
# 2. 编辑文章
5
vim content/posts/my-new-post.md
6

7
# 3. 本地预览
8
hugo server --buildDrafts
9

10
# 4. 发布
11
git add . && git commit -m "new post: 文章标题" && git push

写完 push 就上线，GitHub Actions 自动部署。