Markdown 是一种轻量级标记语言，用纯文本格式就能写出结构清晰的文档。这篇笔记整理了常用语法和写作技巧。

基础语法

标题

用 # 表示标题层级，1~6 级：

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

文本样式

效果	语法
粗体	**粗体**
斜体	*斜体*
删除线	~~删除线~~
行内代码	`行内代码`

链接与图片

[链接文字](https://example.com)
![图片描述](https://example.com/image.png)

列表

无序列表用 - 或 *，有序列表用数字：

- 项目一
- 项目二
  - 嵌套子项

1. 第一步
2. 第二步

引用

> 这是一段引用文字
> 可以多行

代码块

用三个反引号包裹，指定语言可以获得语法高亮：

```python
def hello():
    print("Hello, Markdown!")
```

效果：

def hello():
    print("Hello, Markdown!")

分隔线

三个或更多的 ---、***、___：

---

表格

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A   | B   | C   |
| D   | E   | F   |

扩展语法

不同平台支持的扩展可能不同，以下是常用扩展：

任务列表

- [x] 已完成
- [ ] 待办事项

脚注

这是一段带脚注的文字[^1]

[^1]: 这是脚注内容

数学公式

VitePress 配合 markdown-it-mathjax3 支持 LaTeX 数学公式：

行内公式：$E = mc^2$ → $E = mc^2$

块级公式：

$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

Emoji

:smile: :rocket: :heart:

Frontmatter 配置

在 .md 文件顶部用 --- 包裹 YAML 配置：

---
title: 文章标题
date: 2026-06-01
tags: [教程, Markdown]
cover: /covers/your-post-slug.svg
---

本博客支持的 frontmatter 字段：

字段	说明	必填
title	文章标题	✅
date	发布日期	✅
tags	标签列表	✅
cover	封面图 URL	❌

写作建议

好的排版让阅读更愉悦

• 善用标题层级，让文章结构清晰
• 段落之间空一行，避免文字拥挤
• 代码块要指定语言，获得语法高亮
• 适当使用列表和表格，提高信息密度
• 配图合理，大段文字中加入图片缓解阅读疲劳

常用工具推荐

工具	用途
Typora	所见即所得的 Markdown 编辑器
VS Code	配合插件写 Markdown 很方便
Obsidian	笔记管理 + 双向链接
Excalidraw	画图导出为图片插入文章

---

写好 Markdown 不难，多写几篇就熟练了。最重要的是——开始写 🚀