写文章用得上的 Markdown 速查
加粗、列表、链接、图片、引用、代码 —— 写博客需要的格式,一页看完。

写文章用的是 Markdown:一种用符号代替排版按钮的写法。常用的就这几个,看一遍就会了。
这篇留着当参考,也可以直接删掉。
标题
## 二级标题
### 三级标题
文章正文里不要用一级标题(单个 #),因为页面顶部那个大标题已经是一级了。
强调
**加粗**,*斜体*,~~删除线~~
加粗,斜体,删除线
列表
- 第一项
- 第二项
- 缩进两个空格就是子项
1. 有序列表
2. 第二条
- 第一项
- 第二项
- 缩进两个空格就是子项
链接和图片
[显示的文字](https://example.com)

图片要先放进 src/assets/ 文件夹,再按上面的写法引用。方括号里的说明文字很重要:看不见图片的人靠它理解内容,搜索引擎也看它。
引用
> 引用的内容放在大于号后面。
引用的内容放在大于号后面。
代码
行内代码用一对反引号包起来:像这样。
整段代码用三个反引号包起来,第一行可以写语言名字(会自动上色):
def hello(name):
print(f"你好,{name}")
分隔线和表格
---
| 列一 | 列二 |
| --- | --- |
| 内容 | 内容 |
| 列一 | 列二 |
|---|---|
| 内容 | 内容 |
两个容易踩的坑
空行很重要。 两段文字之间一定要空一行,否则会被挤成一段。
日期格式固定。 文章顶部的 pubDate 要写成 2026-11-20 这种格式。写成 2026/11/20 或者 11月20日 会报错。