Markdown 语法全面指南
基本语法
标题
Markdown 使用 #
符号创建标题,符号数量表示标题级别:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落与换行
段落之间用一个或多个空行分隔。
要创建换行(软回车),在行末添加两个以上的空格然后回车,或直接使用 HTML 的 <br>
标签。
文本格式化
- 加粗:
**文本**
或__文本__
- 斜体:
*文本*
或_文本_
- 粗斜体:
***文本***
或___文本___
删除线:~~文本~~
列表
无序列表
可以使用 *
、+
或 -
作为列表标记:
* 项目一
* 项目二* 子项目* 子项目
* 项目三
效果:
- 项目一
- 项目二
- 子项目
- 子项目
- 项目三
有序列表
使用数字加点来创建:
1. 第一项
2. 第二项
3. 第三项
效果:
- 第一项
- 第二项
- 第三项
链接与图片
链接
创建链接的语法是 [链接文本](URL)
例如:[Markdown 指南](https://www.markdownguide.org)
效果:Markdown 指南
图片
插入图片的语法是 
例如:
代码
行内代码
使用反引号()包裹内容:``
代码` ``
代码块
使用三个反引号(```)创建代码块,还可以指定语言以启用语法高亮:
```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的优点
- 易学易用,语法简洁
- 可读性强,即使不转换也易于阅读
- 专注内容,减少排版干扰
- 兼容HTML,可嵌入HTML标签
- 广泛支持,几乎所有主流平台都支持
常用Markdown编辑器
- Visual Studio Code(配合插件)
- Typora
- Obsidian
- Notion
- Markdown Editor(在线)
小技巧
- 转义字符:使用反斜杠(
\
)来显示原本用于格式化Markdown的字符 - HTML兼容:当Markdown不够用时,可以插入HTML代码
- 缩进:在列表项中缩进,可以创建多级列表
- 链接引用:使用
[链接文本][标识符]
然后在文档其他地方定义[标识符]: URL