Markdown 语法全攻略

Markdown 是一种轻量级标记语言，它以简洁、易读易写的特点受到了广大开发者和写作者的喜爱。本文将详细介绍 Markdown 的各种语法，包括标题、段落、列表、链接、图片、代码块等，并结合具体场景和示例进行展示。

一、标题

Markdown 支持六级标题，分别用#的数量表示不同级别。

  • #一级标题
  • ##二级标题
  • ###三级标题
  • 以此类推，最多到六级标题。

示例:

  • 一级标题：
markdown
1

# 这是一级标题
  • 二级标题：
markdown
1

## 这是二级标题
  • 三级标题：
markdown
1

### 这是三级标题

二、段落

语法介绍

段落之间用一个空行隔开。

用法介绍

直接输入文本即可创建段落。

具体示例及对应 Markdown 代码

markdown
1
2
3

这是第一个段落。

这是第二个段落。

三、列表

1. 无序列表

  • 语法介绍：使用-、*或+作为无序列表的标记。
  • 用法介绍：在标记后加上一个空格，然后输入列表项内容。
  • 具体示例及对应 Markdown 代码：
markdown
1
2
3

- 列表项 1
- 列表项 2
- 列表项 3

也可以使用*或+：

markdown
1
2
3

* 列表项 1
* 列表项 2
* 列表项 3
markdown
1
2
3

+ 列表项 1
+ 列表项 2
+ 列表项 3

2. 有序列表

  • 语法介绍：使用数字加英文句号作为有序列表的标记。
  • 用法介绍：数字后面加上一个英文句号和一个空格，然后输入列表项内容。列表项会自动按数字顺序排列。
  • 具体示例及对应 Markdown 代码：
markdown
1
2
3

1. 列表项 1
2. 列表项 2
3. 列表项 3

四、链接

语法介绍

链接的语法为[链接文本](链接地址)。

用法介绍

  • 可以直接使用 URL 作为链接地址。
  • 也可以使用相对路径或绝对路径指向本地文件或其他资源。

具体示例及对应 Markdown 代码

  • 链接到网页：
markdown
1

[百度](https://www.baidu.com)
  • 链接到本地文件（相对路径）： 假设在当前目录下有一个名为document.pdf的文件，可以这样链接：
markdown
1

[文档](document.pdf)

五、图片

语法介绍

图片的语法为![图片替代文本](图片地址)。

用法介绍

  • 图片替代文本在图片无法加载时显示，也有助于提高可访问性。
  • 图片地址可以是本地文件路径或网络 URL。

具体示例及对应 Markdown 代码

  • 插入网络图片：
markdown
1

![可爱的猫咪](https://example.com/cat.jpg)
  • 插入本地图片（相对路径）： 假设在当前目录下有一个名为image.png的图片，可以这样插入：
markdown
1

![美丽的风景](image.png)

六、强调

1. 斜体

  • 语法介绍：使用*或_包裹需要强调的文本。
  • 用法介绍：在文本前后分别加上一个*或_。
  • 具体示例及对应 Markdown 代码：
markdown
1
2

*这是斜体文本*
_这也是斜体文本_

2. 粗体

  • 语法介绍：使用**或__包裹需要加粗的文本。
  • 用法介绍：在文本前后分别加上两个*或_。
  • 具体示例及对应 Markdown 代码：
markdown
1
2

**这是粗体文本**
__这也是粗体文本__

3. 同时使用斜体和粗体

  • 语法介绍：使用***或___包裹需要同时斜体和加粗的文本。
  • 用法介绍：在文本前后分别加上三个*或_。
  • 具体示例及对应 Markdown 代码：
markdown
1
2

***这是斜体加粗文本***
___这也是斜体加粗文本___

七、代码块

1. 行内代码

  • 语法介绍：使用反引号（`）包裹行内代码。
  • 用法介绍：在需要插入代码的地方使用反引号包裹代码。
  • 具体示例及对应 Markdown 代码：
markdown
1

这是一段包含行内代码的文本，比如`print("Hello, World!")`。

2. 代码块

  • 语法介绍：使用三个反引号包裹代码块，并在开头的反引号后指定代码语言（可选）。
  • 用法介绍：在需要插入代码块的地方，先输入三个反引号，然后在后面指定代码语言（如果需要语法高亮），接着输入代码，最后再输入三个反引号。
  • 具体示例及对应 Markdown 代码：
markdown
1
2
3

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

八、引用

语法介绍

引用的语法为> 加上引用的内容。

用法介绍

可以嵌套引用，即一个引用中可以包含另一个引用。

具体示例及对应 Markdown 代码

markdown
1
2

> 这是一个引用。
> > 这是一个嵌套引用。

九、分割线

语法介绍

可以使用三个以上的星号***、减号---或下划线___来创建分割线。

用法介绍

在一行中单独输入这些符号即可创建分割线。

具体示例及对应 Markdown 代码

markdown
1
2
3

***
---
___

十、表格

语法介绍

使用|来分隔表格的列，使用-来分隔表头和表体，使用:来对齐列。

用法介绍

  • 第一行是表头，用|分隔不同的列名。
  • 第二行是分隔表头和表体的行，用-表示，并且可以在需要对齐的列名下面加上:来指定对齐方式（左对齐、右对齐或居中对齐）。
  • 从第三行开始是表体内容，每行用|分隔不同的列值。

具体示例及对应 Markdown 代码

markdown
1
2
3
4

| 列 1 | 列 2 | 列 3 |
| ---- | ----: | :----: |
| 值 1 | 值 2 | 值 3 |
| 值 4 | 值 5 | 值 6 |

十一、任务列表

语法介绍

任务列表的语法为- [ ]表示未完成的任务，- [x]表示已完成的任务。

用法介绍

在-后面加上一个空格，然后是[ ]或[x]，再加上一个空格和任务描述。

具体示例及对应 Markdown 代码

markdown
1
2
3

- [ ] 任务 1
- [x] 任务 2
- [ ] 任务 3

十二、总结

Markdown 语法简洁明了，易于掌握。通过本文的介绍，相信你已经对 Markdown 的各种语法有了更深入的了解。在实际使用中，可以根据不同的需求灵活运用这些语法，提高文档的编写效率和可读性。无论是写博客、做笔记还是编写技术文档，Markdown 都是一个非常实用的工具。