– Markdown常用语法速查手册
Markdown语法速查手册
Markdown是一种轻量级的标记语言,旨在通过简洁的符号和格式来实现文档的排版和格式化。它广泛应用于博客、文档、GitHub项目、论坛帖子等场景,因为它不仅易于学习,而且使文本更具可读性。本文将详细介绍Markdown的语法,并提供一个速查手册,帮助你快速掌握常用的Markdown语法。
1. Markdown基础
Markdown文件以.md
为后缀。Markdown的最大特点就是简洁,通过一些简单的符号和字符来表示文档的结构和格式。
1.1 标题
Markdown中的标题通过在文本前加上#
符号来创建。标题的级别由#
的数量决定,最多支持六级标题。
```markdown
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
```
效果:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
1.2 段落与换行
Markdown中的段落通过空行来分隔。换行时,可以在行末加两个空格后按回车,或者直接使用HTML标签<br>
。
```markdown
这是第一段。
这是第二段。
这是第二段的下一行。
```
效果:
这是第一段。
这是第二段。
这是第二段的下一行。
1.3 强调
Markdown通过星号*
或下划线_
来实现文本的强调。
- 单星号或下划线表示斜体。
- 双星号或双下划线表示加粗。
markdown
*斜体* 或 _斜体_
**加粗** 或 __加粗__
效果:
斜体 或 斜体
加粗 或 加粗
1.4 列表
Markdown支持有序列表和无序列表。
无序列表
无序列表使用星号*
、加号+
或减号-
来表示。
markdown
- 项目一
- 项目二
- 项目三
有序列表
有序列表则使用数字加点1.
、2.
、3.
等来表示。
markdown
1. 第一项
2. 第二项
3. 第三项
效果:
- 项目一
- 项目二
-
项目三
-
第一项
- 第二项
- 第三项
1.5 引用
引用通过>
符号来表示。你可以嵌套多层引用,通过多个>
符号来实现。
```markdown
这是一个引用
这是一个嵌套引用
```
效果:
这是一个引用
这是一个嵌套引用
1.6 分隔线
Markdown支持使用三个或更多的星号*
、减号-
或下划线_
来创建分隔线。
```markdown
```
效果:
1.7 链接
Markdown中的链接使用方括号[]
表示链接文本,后跟圆括号()
表示链接地址。如果需要在链接中加入标题属性,可以在URL后加上引号。
markdown
[GitHub](https://github.com)
[Google](https://www.google.com "Google 搜索")
效果:
1.8 图片
图片的语法与链接类似,只不过在链接前加上一个感叹号!
。
markdown

效果:
1.9 代码
Markdown支持行内代码和代码块的插入。
行内代码
行内代码使用反引号`
包围。
markdown
这是 `行内代码` 的示例。
效果:
这是 行内代码
的示例。
代码块
代码块使用三个反引号```
来表示,或者使用缩进四个空格。
markdown
这是一个代码块
效果:
这是一个代码块
1.10 表格
Markdown支持创建表格,表格的列通过|
分隔,表头和表格内容之间需要用-
符号分隔。
markdown
| 头1 | 头2 | 头3 |
|-----|-----|-----|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
效果:
| 头1 | 头2 | 头3 |
|-------|-------|-------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
2. 高级语法
2.1 自动链接
Markdown支持自动链接,即直接写入URL或电子邮件地址,Markdown会自动将其转换为链接。
markdown
http://www.example.com
[email protected]
效果:
http://www.example.com
[email protected]
2.2 脚注
一些Markdown的扩展(如GitHub Flavored Markdown)支持脚注。脚注通常通过方括号和数字来标记。
```markdown
这是一个脚注示例^1。
```
效果:
这是一个脚注示例^1。
2.3 自定义HTML
Markdown支持插入HTML标签。这使得你能够在Markdown文档中使用更复杂的布局和样式。
```markdown
```
效果:
2.4 任务列表
GitHub Flavored Markdown支持任务列表,任务列表项通过- [ ]
表示未完成的任务,通过- [x]
表示已完成的任务。
markdown
- [ ] 任务1
- [x] 任务2
- [ ] 任务3
效果:
- [ ] 任务1
- [x] 任务2
- [ ] 任务3
2.5 评论
Markdown本身不支持评论,但你可以使用HTML注释来实现。
```markdown
```
效果:
(不会显示任何内容)
3. 总结
Markdown是一种非常轻量且易于学习的标记语言,它帮助我们以最简洁的方式格式化文本。在本文中,我们介绍了Markdown的基础语法和一些常见的高级语法,包括标题、段落、列表、链接、图片、代码、表格等内容。随着你对Markdown的掌握,你将能够快速而高效地创建各种类型的文档。
这篇Markdown语法速查手册希望能帮助你快速上手,并提高你在写作和排版中的效率。由于Markdown本身的扩展性,可能会有一些平台特定的语法和功能,了解这些扩展可以帮助你在不同环境下充分利用Markdown的优势。