Markdown 指北：快速上手
什么是 Markdown
Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后将其转换成有效的 XHTML（或者 HTML），是一种适合或为笔记记录的语言
教程简介
本教程将引导你从零开始，逐步掌握 Markdown 的核心语法直至高级技巧。
并且内容将会分为以下三个阶段：
入门 ⭐️
标题
文本强调
加粗
斜体
删除线
列表
无序列表
有序列表
引用
代码
行内代码
块级代码
链接与图片
注释
水平分割线
进阶 ⭐️⭐️
任务列表
表格
转义字符
自动链接
高阶 ⭐️⭐️⭐️
脚注
定义列表
数学公式
行内公式
块级公式
Mermaid
HTML 标签混用
入门 ⭐️
标题（Headings）
使用
#号的数量来表示标题的级别（1-6 级）。
语法
# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)
##### 五级标题 (H5)
###### 六级标题 (H6)效果
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
文本强调 (Emphasis)
使用
*、_、~标记文本，用于加粗、斜体或删除线。
语法
**加粗文本** 或 __加粗文本__
*斜体文本* 或 _斜体文本_
***加粗并斜体***
~~删除线文本~~效果
加粗文本 或 加粗文本
斜体文本 或 斜体文本
加粗并斜体
删除线文本
列表 (Lists)
1）无序列表
使用
-、+或*加上空格，用于标记无序列表元素
语法
- 项目 1
- 项目 2
- 子项目 2.1 (缩进 2 个空格或 1 个 Tab)
- 子项目 2.1.1
- 子项目 2.2效果
项目 1
项目 2
子项目 2.1 (缩进 2 个空格或 1 个 Tab)
子项目 2.1.1
子项目 2.2
2）有序列表
使用
数字加点.加上空格，用于标记有序列表元素
语法
1. 步骤1
2. 步骤2
3. 步骤3效果
步骤1
步骤2
步骤3
引用 (Blockquotes)
使用
>符号，标记引用，可以嵌套。
语法
> 这是一段引用文本。
> > 这是嵌套引用。
> > > 又嵌套了一层
> > 当然可以出来效果
这是一段引用文本。
这是嵌套引用。
又嵌套了一层
当然可以出来
代码 (Code)
1）行内代码
使用反引号
`包裹，标记代码。
语法
这是一个`行内代码`效果
这是一个 行内代码
2）块级代码
使用三个反引号
```包裹，并可指定语言以实现语法高亮。
语法
```python
def Hello(name : str):
print(f"你好，{name}")
Hello("Player")
```
效果
def Hello(name : str):
print(f"你好，{name}")
Hello("Player")链接与图片
语法
<!--
格式：
[链接文字](https://www.example.com)
-->
示例：
[这里是我的博客](https://blog.playereg.top)
效果示例
示例： 这里是我的博客
注释（Comments）
Markdown 的注释沿用了 HTML 的注释语法：
<!-- -->注释
语法
<!--
这是一句注释，是没有任何效果的
-->没有效果
水平分割线 (Horizontal Rule)
使用三个以上的
-或*。
语法
上部
---
中部
***
下部效果
上部
中部
下部
进阶 ⭐️⭐️
任务列表 (Task Lists)
常用于待办事项清单。
语法
<!-- 无序 -->
- [x] 任务1
- [ ] 任务2
- [ ] 任务3
<!-- 有序 -->
1. [x] 任务1
2. [ ] 任务2
3. [ ] 任务3效果
- 任务1
- 任务2
- 任务3
- 任务1
- 任务2
- 任务3
表格 (Tables)
Markdown 原生表格语法。
语法
| 姓名 | 年龄 | 职业 |
| :--- | :---: | ---: |
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |效果
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
注：冒号
:用于控制对齐方式（左对齐、居中、右对齐）。
转义字符 (Escaping)
如果你想显示 Markdown 的特殊符号（如
*或#），和大部分语言一样，需要在前面加反斜杠\。
语法
"\\"是转义字符
\# 这不是标题
\*\*这不是加粗\*\*效果
"\"是转义字符
# 这不是标题
**这不是加粗**
自动链接
直接写入 URL 或邮箱地址，某些解析器会自动将其转换为链接。
语法
<!-- URL -->
<https://blog.playereg.top>
<!-- Email -->
<gaster@vip.playereg.top>高阶 ⭐️⭐️⭐️
注意：部分高级功能取决于你使用的 Markdown 编辑器或平台（如 GitHub, Typora, Obsidian, VS Code）是否支持扩展语法。（博客可能不支持展示这些效果，将使用其他编辑器的截图展示）
脚注 (Footnotes)
为文本添加注释，点击可跳转到底部。
语法
这是一个需要解释的概念[^1]。
又是一个需要解释的概念[^1]。
[^1]: 这里是脚注1的具体解释内容。
另一个需要解释的概念[^2]。
[^2]: 这里是脚注2的具体解释内容。效果
定义列表 (Definition Lists)
部分解析器支持，如 Typora, Pandoc
语法
术语 A
: 定义 A 的解释
术语 B
: 定义 B 的解释效果
数学公式 (MathJax / LaTeX)
广泛用于技术文档，需环境支持
行内公式
语法
当 $ a \ne 0 $ 时，方程 $ ax^2 + bx + c = 0 $ 有两个解。效果
当 时，方程 有两个解。
块级公式
语法
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$效果
Mermaid
可使用
Mermaid绘制流程图和时序图
语法
```mermaid
graph TD;
A[开始] --> B{是否成功?};
B -- 是 --> C[结束];
B -- 否 --> D[重试];
D --> B;
```效果
HTML 标签混用
Markdown 兼容 HTML，如果 Markdown 语法无法满足需求，可以直接写 HTML。
语法
<u style="color: green">下划线</u>效果
