← 返回文章列表

从一篇文章开始:搭建自己的数字花园

一个博客不必复杂。用 Markdown 写作,让想法有一个可以长期停留的地方。

这是一篇示例文章,也是一份使用说明。你可以编辑它,或者删除后开始写自己的第一篇札记。

为什么还要写博客

社交平台擅长让内容快速流动,个人博客则适合让内容慢慢积累。一段调试记录、一份阅读笔记,甚至一个尚未完成的想法,都可以在这里保留下来。

不必等到想明白了所有事情,才开始记录。写作本身也是整理思路的过程。

如何添加一篇文章

在 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/,然后在文章里通过绝对站内路径引用:

![图片的说明文字](/images/your-photo.jpg)

代码块可以标注语言,构建时会自动添加语法高亮:

const notes = ['阅读', '记录', '实践'];
notes.forEach((note) => console.log(note));

发布之前

  1. 在 src/site.js 中修改博客名称、作者和站点描述。
  2. 在关于页面介绍自己。
  3. 设置真实的 SITE_URL,让 canonical、RSS 和站点地图使用正确的地址。
  4. 执行 npm run build,确认构建成功。

部署之后,新增或修改文章,再提交到仓库,就能触发下一次自动发布。