写作指南：Markdown 语法速查

每一篇文章都是 posts/ 目录下的一个 Markdown 文件。文件开头的 Frontmatter 定义元信息，正文即所见即所得。本文把全部语法过一遍，写的时候随时回来查。

文章元信息（Frontmatter）

文件最顶部用 --- 包裹的字段：

---
title: 文章标题
date: 2026-07-30
tags: [写作, 指南]
description: 一句话摘要，会显示在首页列表。
draft: false
---

正文的第一个 # 会被当作页面标题而跳过（页面顶部已展示）。章节从 ## 开始：

## 大章节

### 小节（可选，二级编号）

## 自动编号为 01、02……并进入侧栏目录（至少两个标题才会显示目录）。

**粗体** *斜体* `行内代码`

> 这是一段引用。

---

用三个以上连字符表示分隔线。

- 无序列表项
- 无序列表项

1. 有序列表项
2. 有序列表项

代码块用三个反引号包裹，可在开头标注语言；渲染后自动带语言徽标和一键复制按钮。例如：

const blog = "BOLG";
console.log(blog);

想展示「反引号本身」时，先写一个占位说明再贴代码即可（本段前面的 Frontmatter 示例就是标准写法）。

| 列一 | 列二 |
| --- | --- |
| 内容 | 内容 |

![图片说明](./assets/example.png)

[外链](https://example.com) 会新标签打开，[内部链接](./hello-blog.html) 直接跳转。

图片建议放在 posts/assets/ 目录，支持懒加载，file:// 直接打开也能显示。