Markdown 语法全面介绍
Markdown 是一种轻量级标记语言,创建于2004年,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的HTML文档。本文将全面介绍 Markdown 的基本语法和常用功能。 本博客也是采用markdown语法编写,所以本篇文章也作为语法查阅使用。
1. 标题
Markdown 支持六级标题,使用 #
符号表示:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果如下:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2. 段落与换行
在 Markdown 中,段落由一个或多个空行分隔。如果要在段落内换行,可以在行尾添加两个或更多空格,然后按回车键。
这是第一段。
这是第二段。
这是一行,
这是强制换行后的内容。
3. 强调
Markdown 使用星号(*
)和下划线(_
)作为强调标记:
*斜体文本* 或 _斜体文本_
**粗体文本** 或 __粗体文本__
***粗斜体文本*** 或 ___粗斜体文本___
~~删除线文本~~
效果:
斜体文本 或 斜体文本
粗体文本 或 粗体文本
粗斜体文本 或 粗斜体文本
删除线文本
4. 列表
无序列表
无序列表可以使用星号(*
)、加号(+
)或减号(-
)作为列表标记:
* 第一项
* 第二项
* 第三项
+ 第一项
+ 第二项
+ 第三项
- 第一项
- 第二项
- 第三项
效果:
- 第一项
- 第二项
- 第三项
有序列表
有序列表使用数字并加上 .
号来表示:
1. 第一项
2. 第二项
3. 第三项
效果:
- 第一项
- 第二项
- 第三项
嵌套列表
列表嵌套只需在子列表中的选项前面添加四个空格即可:
1. 第一项:
- 第一子项
- 第二子项
2. 第二项:
- 第一子项
- 第二子项
5. 链接
Markdown 支持两种形式的链接语法:行内式和参考式。
行内式
[链接名称](链接地址)
[链接名称](链接地址 "链接标题")
参考式
这是 [参考式链接][id]
[id]: https://www.example.com "可选标题"
6. 图片
插入图片的语法和链接类似,只是前面多了一个感叹号:


7. 引用
在段落前使用 >
符号,表示引用:
> 这是一段引用内容
> 多行引用
>> 嵌套引用
效果:
这是一段引用内容 多行引用
嵌套引用
8. 代码
行内代码
使用反引号(`)包裹代码:
`print("Hello, World!")`
效果:print("Hello, World!")
代码块
使用三个反引号(```)或者四个空格缩进来创建代码块:
```python
def hello_world():
print("Hello, World!")
hello_world()
```
或者:
def hello_world():
print("Hello, World!")
hello_world()
9. 分隔线
可以在一行中使用三个或更多的星号、减号或下划线来创建分隔线:
***
---
___
效果都是一条水平线:
10. 表格
Markdown 表格语法如下:
| 表头1 | 表头2 | 表头3 |
| -----| ----- | ----- |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |
效果:
表头1 | 表头2 | 表头3 |
---|---|---|
单元格1 | 单元格2 | 单元格3 |
单元格4 | 单元格5 | 单元格6 |
通过在表头下方的分隔线中使用冒号(:
),可以设置表格内容的对齐方式:
| 左对齐 | 居中对齐 | 右对齐 |
| :-----| :----: | -----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
11. 任务列表
Markdown 支持任务列表,使用 - [ ]
和 - [x]
语法:
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个未完成任务
效果:
- 已完成任务
- 未完成任务
- 另一个未完成任务
12. 脚注
这里有一个脚注[^1]
[^1]: 这是脚注的内容
13. HTML 支持
Markdown 允许直接在文档中使用 HTML 标签:
<div style="color: red">
这是一段红色文本
</div>
总结
Markdown 是一种简洁、高效的文本格式化语言,广泛应用于博客、文档编写、README文件和论坛帖子等场景。掌握这些基本语法,你就能够创建格式丰富、结构清晰的文档了。更多高级用法可以参考 Markdown 官方文档或其他扩展语法,如 GitHub Flavored Markdown。
以上内容已经包含了Markdown语法的全面介绍,并为每种语法都提供了相应的示例。您可以根据需要进一步修改或增加其他Markdown特性。