记录，让思考有迹可循

创建文章#

在项目根目录运行：

1
pnpm new-post -- my-first-post

文章保存在 src/content/posts/ 中。也可以直接在该目录新建 .md 文件。

填写文章信息#

文件开头的 frontmatter 控制标题、日期、摘要、分类和标签：

1
---
2
title: 我的第一篇文章
3
published: 2026-10-29
4
description: 用一句话告诉读者，这篇文章值得读的原因。
5
tags: [笔记, 写作]
6
category: 随笔
7
draft: false
8
---

将 draft 设为 true，可以保存尚未准备公开的文章。使用 pinned: true 可以把文章置顶。

写清楚比写得长更重要#

一篇技术笔记可以从三个问题开始：

1. 遇到了什么具体问题？
2. 用什么方法验证和解决？
3. 这个方法有什么适用条件？

代码块请标明语言；标题按层级组织，侧边目录会自动生成。图片可以放在文章旁边，通过相对路径引用。

本地预览#

1
pnpm dev

打开终端给出的地址，确认标题、图片和代码块显示正常。准备发布时运行：

1
pnpm build
2
pnpm preview

生产构建会生成搜索索引。搜索功能请通过构建后的预览验证。

发布前的最后一步#

在 src/config/siteConfig.ts 中，把 siteURL 改为实际域名，以确保 canonical、订阅源和站点地图使用正确地址。修改 src/config/profileConfig.ts 中的昵称与简介，博客就真正属于你了。