你好，世界

2026-10-23T00:00:00.000Z

这是这个博客的第一篇文章。

它现在跑的这套主题叫 Firefly，是一个开源的 Astro 博客模板。我把它拉下来，改掉名字、去掉用不上的页面，然后它就变成我自己的站了。

我为什么想写#

要说天地万物各有起源那为啥我要开始写博客嘞(ﾟ⊿ﾟ)?

且来看看叭(⁄ ⁄>⁄ ▽ ⁄<⁄ ⁄)

主要三个原因：

我的生活里不只有我一个人还有狠心的学长学姐！！！
健忘健忘一见就忘那什么东西能把我看见的、学会的记录下来嘞？我想写博客就是那个既能助我理清思路，又能让我肆意发挥的方子啦。
嘿嘿嘿嘿嘿万一有人看到了我的blog然后直接迷失在我的才华里了呢（bushi

以后应该会写一些技术笔记和一些生活记录，多多支持呦(｡･ω･｡)

打算放什么#

技术 — 写代码时遇到的问题、解决过程、学到的东西
生活 — 一些不值得发朋友圈但想留着的片段
杂七杂八 — 看到的、想到的、没分类的

分类不用太整齐。写得多了自然会分出脉络。

关于这个站#

技术上是纯静态的：文章都是 Markdown 文件，构建时生成 HTML，没有数据库也没有后端。这意味着它很轻、很快，也不会因为服务器出问题就挂掉。

文章写好、git push、自动部署，就这样。

先到这儿，第一篇不会长。

这个博客怎么写文章

2026-10-23T00:00:00.000Z

写给未来的自己。免得每次想发文章都要翻文档。

文章放在哪#

1
src/content/posts/

新建一个 .md 文件就是一篇新文章。文件名最好是英文，会成为网址的一部分。

也可以用命令行创建（会带上模板）：

Terminal window

1
pnpm new-post my-new-post

开头那段配置#

每篇文章最上面夹在 --- 之间的部分，叫 frontmatter。最少只要两行：

1
---
2
title: 文章标题
3
published: 2026-10-23
4
---

常用的还有这些：

字段	作用
`title`	标题，必填
`published`	发布日期，必填
`description`	摘要，显示在列表卡片和搜索结果里
`tags`	标签，写成 `[标签1, 标签2]`
`category`	分类，只能填一个
`image`	封面图，相对路径，比如 `./images/cover.avif`
`pinned`	设为 `true` 就置顶
`draft`	设为 `true` 就只是草稿，不会发布
`password`	设置后文章需要密码才能看

正文能写什么#

普通 Markdown 都支持：标题、列表、表格、链接、加粗、引用。

代码块会带语法高亮和行号：

1
```js
2
console.log("hello");
3
```

提示框用 GitHub 的写法：

1
> [!NOTE]
2
> 这是一条提示。
3

4
> [!WARNING]
5
> 这是一条警告。

数学公式用 $ 包裹，行内 $a^2 + b^2 = c^2$ ，独立成行用两个美元符号。

图表支持 Mermaid 和 PlantUML，写代码块时语言填 mermaid 或 plantuml 就行。

图片放哪#

在文章同目录下建个 images 文件夹，图片丢进去，正文里这样引用：

1
![说明文字](./images/1.avif)

构建时会自动压缩成 WebP，不用自己处理。

改完怎么发布#

改完推送到 GitHub，托管平台会自动重新构建，一两分钟后线上就更新了。

本地想看效果就先跑 pnpm dev，改文件浏览器会自动刷新。

宥不宥的博客