这是一篇示例文章,也是一份使用说明。你可以编辑它,或者删除后开始写自己的第一篇札记。
为什么还要写博客
社交平台擅长让内容快速流动,个人博客则适合让内容慢慢积累。一段调试记录、一份阅读笔记,甚至一个尚未完成的想法,都可以在这里保留下来。
不必等到想明白了所有事情,才开始记录。写作本身也是整理思路的过程。
如何添加一篇文章
在 src/content/blog/ 下新增一个 Markdown 文件,例如 my-first-post.md。文件名会成为文章地址:/posts/my-first-post/。
文章开头使用 frontmatter 描述标题、摘要、日期和标签:
---
title: '我的第一篇文章'
description: '用一句话说明文章内容。'
pubDate: 2026-10-09
tags: ['生活', '阅读']
draft: false
---
draft: true 表示草稿。草稿不会出现在文章页面、首页、标签、归档、搜索、RSS 或站点地图中。不要把密码等敏感内容写进草稿;如果源码仓库公开,Markdown 文件本身仍然可见。
图片与代码
把图片放在 public/images/,然后在文章里通过绝对站内路径引用:

代码块可以标注语言,构建时会自动添加语法高亮:
const notes = ['阅读', '记录', '实践'];
notes.forEach((note) => console.log(note));
发布之前
- 在
src/site.js中修改博客名称、作者和站点描述。 - 在关于页面介绍自己。
- 设置真实的
SITE_URL,让 canonical、RSS 和站点地图使用正确的地址。 - 执行
npm run build,确认构建成功。
部署之后,新增或修改文章,再提交到仓库,就能触发下一次自动发布。