这个博客怎么写文章

文章放在哪#

1
src/content/posts/

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

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

1
pnpm new-post my-new-post

开头那段配置#

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

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

常用的还有这些：

正文能写什么#

普通 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，改文件浏览器会自动刷新。