Markdown 是一种很适合写博客和笔记的轻量格式。你不用记全部规则，先把下面这些高频写法熟悉起来，就足够支撑日常写文章了。

建议写文章时优先使用 # 和 ## 组织结构，因为当前博客的文章目录会读取这两级标题。

1. 标题

写法：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

实际效果：

一级标题效果

二级标题效果

三级标题效果

四级标题效果

五级标题效果

六级标题效果

在博客正文里，更推荐从 ## 开始写。文章的大标题已经由页面自动显示了。

2. 文字样式

写法：

**加粗**

*斜体*

***加粗斜体***

~~删除线~~

`行内代码`

实际效果：

加粗

斜体

加粗斜体

~~删除线~~

行内代码

3. 段落和换行

段落写法：

这是第一段。

这是第二段。

实际效果：

这是第一段。

这是第二段。

强制换行写法：

第一行  
第二行

实际效果：

第一行
第二行

实际写博客时，更推荐用“空一行”来分段，可读性更好。

4. 列表

无序列表写法：

- Python
- Linux
- VPS

实际效果：

Python
Linux
VPS

有序列表写法：

1. 第一步
2. 第二步
3. 第三步

实际效果：

第一步
第二步
第三步

嵌套列表写法：

- Python
  - 判断语句
  - 循环
- Linux
  - `cd`
  - `ls`

实际效果：

Python
- 判断语句
- 循环
Linux
- cd
- ls

5. 引用

写法：

> 这是一段引用内容。

实际效果：

这是一段引用内容。

连续多行引用写法：

> 第一行
> 第二行
> 第三行

实际效果：

第一行第二行第三行

这种写法在 Markdown 里通常会被当成同一段引用，所以显示出来可能会连成一段。它的意义是“这几行都属于同一个引用块”，不是强制每行都换行。

如果你想让引用里分成多个段落，可以这样写：

> 第一段引用。
>
> 第二段引用。
>
> 第三段引用。

实际效果：

第一段引用。

第二段引用。

第三段引用。

引用里也可以使用加粗和行内代码。

写法：

> 注意：`return` 是返回结果，**不是打印结果**。

实际效果：

注意：return 是返回结果，不是打印结果。

6. 行内代码和代码块

行内代码写法：

使用 `print()` 输出内容。

实际效果：

使用 print() 输出内容。

代码块写法：

```python
print("hello")
```

实际效果：

print("hello")

常用语言标签示例：

```bash
npm run dev
```

```js
console.log("hello")
```

```css
.card {
  border-radius: 8px;
}
```

```json
{
  "name": "ethans-lab"
}
```

实际效果：

npm run dev

console.log("hello")

.card {
  border-radius: 8px;
}

{
  "name": "ethans-lab"
}

7. 四个反引号

如果你要在文章里展示“三个反引号代码块应该怎么写”，外层就用四个反引号。

写法：

````md
```python
print("hello")
```
````

实际效果：

```python
print("hello")
```

简单记：

一个反引号：一句话里的小代码，比如 print()
三个反引号：真正的代码块
四个反引号：展示代码块写法本身

8. 表格

写法：

| 类型 | 例子 | 说明 |
| --- | --- | --- |
| 关键字 | `if`、`for` | Python 语法 |
| 函数 | `print()` | 输出内容 |
| 方法 | `.append()` | 列表自己的功能 |

实际效果：

类型	例子	说明
关键字	`if`、`for`	Python 语法
函数	`print()`	输出内容
方法	`.append()`	列表自己的功能

对齐写法：

| 左对齐 | 居中 | 右对齐 |
| --- | :---: | ---: |
| A | B | C |
| 100 | 200 | 300 |

实际效果：

左对齐	居中	右对齐
A	B	C
100	200	300

9. 链接

外部链接写法：

[OpenAI](https://openai.com)

实际效果：

OpenAI

博客内部链接写法：

[查看项目](/projects/)

实际效果：

查看项目

10. 图片

图片写法：

![Markdown 示例图](/images/blog/markdown-demo.svg)

实际效果：

Markdown 示例图

文件建议放在这些目录里：

public/images/blog/
public/images/projects/
public/images/notes/

引用图片时不要写 public，比如文件在 public/images/blog/demo.png，文章里写：

![图片说明](/images/blog/demo.png)

11. 分割线

写法：

---

实际效果：

适合用来分隔大段内容，但不要太频繁使用。

12. 任务清单

写法：

- [x] 已完成
- [ ] 未完成

实际效果：

已完成
未完成

13. 转义符

如果你想显示 Markdown 符号本身，可以在前面加反斜杠。

写法：

\# 这不会变成标题
\* 这不会变成列表
\` 这不会变成代码

实际效果：

# 这不会变成标题

* 这不会变成列表

` 这不会变成代码

14. Frontmatter

博客文件开头这段不是正文，而是文章信息。

写法：

---
title: "文章标题"
description: "文章简介"
pubDate: "2026-05-24"
updatedDate: "2026-05-24"
pinned: false
tags: ["Markdown", "博客写作"]
draft: false
---

实际效果：

Frontmatter 不会显示在正文里。它会变成页面顶部的文章标题、简介、发布日期、最后修改时间、标签，以及博客列表页里的卡片信息。

字段说明：

字段	作用
`title`	文章标题
`description`	文章简介
`pubDate`	发布日期
`updatedDate`	最后修改日期
`pinned`	是否置顶
`tags`	标签
`draft`	是否草稿

15. 常用文章模板

写法：

---
title: "文章标题"
description: "文章简介"
pubDate: "2026-05-24"
updatedDate: "2026-05-24"
pinned: false
tags: ["学习笔记"]
draft: false
---

## 1. 第一部分

这里写正文，重点可以用 **加粗**，函数名可以用 `print()`。

> 这里可以写提示或注意事项。

### 1.1 小标题

```python
print("hello")
```

| 类型 | 说明 |
| --- | --- |
| 示例 | 内容 |

---

## 2. 第二部分

- 第一条
- 第二条

实际效果就是一篇结构完整的文章：有标题信息、有正文层级、有提示块、有代码块、有表格，也有列表。

先把这些写法用熟，你的博客内容就会清楚很多。