生成器是手写的一个极简 Markdown 解析器，只实现博客真正用得上的语法。下面这些全部支持，超出范围的会按普通文本处理。

标题

## 二级标题
### 三级标题

文章标题（h1）由 front matter 里的 title 生成，正文里不要写 #。

段落与强调

普通段落直接写，一行写完不用管换行。
中文换行不会多出空格，英文会补一个。

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

段落之间空一行。中文标点用全角，代码和英文单词两侧留一个空格。

列表

- 无序列表
- 第二项

1. 有序列表
2. 第二项

不支持嵌套列表。需要多层结构，用表格或者拆成小标题更清楚。

引用

> 被引用的话。
> 可以有多行。

代码块

```bash
python build.py
```

语言名可以不写。代码块内不做任何解析，HTML 会被转义。

表格

| 方式 | 适合 |
| --- | --- |
| 拖拽 | 页面少 |
| 命令行 | 固定流程 |

第二行是分隔行，必须有。列宽不用对齐，写起来丑没关系。

链接与图片

[链接文字](/about)
![图片说明](/assets/cover.jpg)

站内链接不带 .html 后缀（/post-xxx），Pages 会自动映射到对应文件。图片放 static/assets/ 目录，引用时写 /assets/文件名。

分隔线

---

正文中间用三条短横线，会渲染成一条细线。注意它和 front matter 的分隔符长得一样，所以分隔线不要写在文件最开头。

裸 HTML

需要精细排版时可以直接写 HTML，整块原样输出：

<div class="center-page">
  <p class="code">404</p>
  <h1>这页不见了</h1>
</div>

不支持的部分

刻意没做的：嵌套列表、脚注、任务列表、数学公式、自动目录。真需要的话，改十几行 build.py 就能补上，但先问问自己是不是真的需要。