1、最基础的模板#

一篇普通公开文章，可以先写成这样：

1
---
2
title: "文章标题"
3
published: 2026-07-01
4
description: "一句话说明这篇文章解决什么问题。"
5
image: "api"
6
tags: ["标签1", "标签2"]
7
category: "分类名称"
8
draft: false
9
comment: true
10
---

我觉得最关键的是 published、category、draft 这三个字段。日期决定归档位置，分类决定读者从哪里找到文章，draft: false 决定文章是否公开显示。

2、标题和描述先写朴素一点#

标题不一定要很花哨，学习博客更重要的是让自己以后能搜索到。例如：

1
Python 路径问题排查
2
pandas 缺失值处理
3
BFS 广度优先搜索模板

这些标题都很直接，过几个月回头找也能知道文章内容。description 可以写成一句问题说明：

1
记录 pandas 中缺失值检查、删除、填充和统计的常用写法。

这样首页和搜索页展示时也比较清楚。

3、分类不要随便新增#

分类最好保持稳定。比如我现在常用的分类有：

1
问题解决
2
博客相关分类
3
计算机视觉
4
数据分析
5
数据结构与算法

如果每篇文章都随手创建一个新分类，后面分类页会变得很乱。更好的做法是：先判断文章属于哪条学习线，再放进已有分类。

4、标签写得比分类细一点#

分类是大方向，标签可以更具体。例如一篇 pandas 文章：

1
tags: ["数据分析", "pandas", "缺失值"]
2
category: "数据分析"

这样以后既可以按“数据分析”看一组文章，也可以按“pandas”找到同一个工具相关的笔记。

5、发布前检查清单#

每次发布前，我会简单看一下：

1
1. published 是否是今天或正确发布日期
2
2. category 是否属于已有分类
3
3. tags 是否和正文主题一致
4
4. draft 是否为 false
5
5. comment 是否按需要开启
6
6. 正文第一段是否说明了问题背景

这个检查不复杂，但能减少很多发布后的修改。

总结#

frontmatter 是博客文章的元信息。它不属于正文内容，但会影响文章是否展示、如何归档、进入哪个分类。把模板固定下来，可以让写文章更像一个稳定流程，而不是每次都临时想字段怎么填。