– 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 搜索")

效果:

GitHub
Google

1.8 图片

图片的语法与链接类似,只不过在链接前加上一个感叹号!

markdown
![Alt text](image.jpg)

效果:

Alt text

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的优势。

THE END