Markdown 语法全面指南

基本语法

标题

Markdown 使用 # 符号创建标题，符号数量表示标题级别：

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

段落与换行

段落之间用一个或多个空行分隔。

要创建换行（软回车），在行末添加两个以上的空格然后回车，或直接使用 HTML 的 <br> 标签。

文本格式化

• 加粗：**文本** 或 __文本__
• 斜体：*文本* 或 _文本_
• 粗斜体：***文本*** 或 ___文本___
• 删除线：~~文本~~

列表

无序列表

可以使用 *、+ 或 - 作为列表标记：

* 项目一
* 项目二
  * 子项目
  * 子项目
* 项目三

效果：

• 项目一
• 项目二
  • 子项目
  • 子项目
• 项目三

有序列表

使用数字加点来创建：

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

效果：

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

链接与图片

链接

创建链接的语法是 [链接文本](URL)

例如：[Markdown 指南](https://www.markdownguide.org)

效果：Markdown 指南

图片

插入图片的语法是 ![替代文本](图片URL)

例如：![Markdown Logo](https://markdown-here.com/img/icon256.png)

代码

行内代码

使用反引号()包裹内容：`` 代码` ``

代码块

使用三个反引号(```)创建代码块，还可以指定语言以启用语法高亮：

```python
def hello_world():
    print("Hello, world!")
```

效果：

def hello_world():
    print("Hello, world!")

引用

使用 > 符号创建引用：

> 这是一段引用文本。
> 
> 这是引用的第二段。

效果：

这是一段引用文本。

这是引用的第二段。

水平分割线

使用三个或更多的星号(***)、减号(---)或下划线(___)：

---

效果：

---

表格

表格语法如下：

| 表头1 | 表头2 | 表头3 |
| ----- | ----- | ----- |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果：

表头1	表头2	表头3
单元格	单元格	单元格
单元格	单元格	单元格

对齐方式：

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容   | 内容     | 内容   |

效果：

左对齐	居中对齐	右对齐
内容	内容	内容

任务列表

用 - [ ] 和 - [x] 语法创建任务列表：

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

效果：

• 已完成任务
• 未完成任务

脚注

添加脚注的语法是：

这里有一个脚注引用[^1]。

[^1]: 这是脚注内容。

数学公式

许多Markdown编辑器支持LaTeX数学公式：

• 行内公式：$E=mc^2$
• 块级公式：$$E=mc^2$$

流程图

一些扩展的Markdown支持流程图、时序图等（如Mermaid语法）：

```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
```

Markdown的优点

1. 易学易用，语法简洁
2. 可读性强，即使不转换也易于阅读
3. 专注内容，减少排版干扰
4. 兼容HTML，可嵌入HTML标签
5. 广泛支持，几乎所有主流平台都支持

常用Markdown编辑器

• Visual Studio Code（配合插件）
• Typora
• Obsidian
• Notion
• Markdown Editor（在线）

小技巧

• 转义字符：使用反斜杠(\)来显示原本用于格式化Markdown的字符
• HTML兼容：当Markdown不够用时，可以插入HTML代码
• 缩进：在列表项中缩进，可以创建多级列表
• 链接引用：使用[链接文本][标识符]然后在文档其他地方定义[标识符]: URL