Markdown语法

一、什么是 Markdown？

Markdown 是一种轻量级标记语言，它使用易读易写的纯文本格式编写文档，可与 HTML 混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。它由 John Gruber 和 Aaron Swartz 在 2004 年创造，并受到了许多人和平台的喜爱和支持。

二、为什么要使用 Markdown？

Markdown 的优点有很多，比如：

• 简单：它只需要一些简单的符号就可以实现各种排版效果。
• 高效：它让人们更多地关注内容本身而非排版，提高了写作效率。
• 兼容：它可以在不同平台上运行，并支持与其他格式转换。
• 灵活：它可以嵌入 HTML 标签或代码块，并支持扩展功能。

三、如何使用 Markdown？

要使用 Markdown，你只需要一个文本编辑器就可以了。你可以选择任何你喜欢或习惯的编辑器，比如 VSCode、Sublime Text、Notepad++ 等。如果你想要实时预览你的文档效果，你也可以选择一些在线编辑器或应用程序，比如 Typora、MarkText、StackEdit 等。

Markdown 的基本语法包括以下几类：

1. 标题

要添加标题，你可以使用 # 来表示不同级别的标题，比如：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

注意，# 后面要有一个空格，否则不会被识别为标题

2. 段落

要添加段落，你只需要在文本中使用空行来分隔不同的段落，比如：

这是第一个段落。

这是第二个段落。

注意，如果你想在段落内换行，你需要在行尾添加两个或以上的空格，否则不会被识别为换行

3. 列表

要添加列表，你可以使用 - 或 + 或 * 来创建无序列表，比如：

- 这是第一项
  或者
+ 这是第一项
  或者
* 这是第一项

注意，这些符号后面要有一个空格，否则不会被识别为列表

4. 表格

要添加表格，你可以使用 | 来分隔单元格，使用 - 来分隔表头和表体，比如：

| 姓名                                              | 年龄 | 性别 |
| ------------------------------------------------- | ---- | ---- |
| 张三                                              | 18   | 男   |
| 李四                                              | 19   | 女   |
| 王五                                              | 20   | 男   |

| 注意，你可以使用 : 来设置单元格的对齐方式，比如：

| :--- 表示左对齐 
---: 表示右对齐
:---: 表示居中对齐

5. 代码

要添加代码，你可以使用反引号 来表示行内代码，比如print(“Hello World!”)`。如果你想添加多行代码或者指定语言，你可以使用三个反引号 ``` 来表示代码块，比如：

`print(add(1, 2))`

```python
def add(a, b):
    return a + b
```

6. 强调

要添加强调，你可以使用 * 或 _ 来表示斜体，比如 这是斜体 或 这也是斜体。你也可以使用 ** 或 __ 来表示粗体，比如 这是粗体 或 这也是粗体。如果你想同时使用斜体和粗体，你可以使用 *** 或 ___ 来表示，比如：

这是***斜体***和**粗体** 或 这也是____斜体___和__粗体__

7. 链接

要添加链接，你可以使用 [文本](网址) 的格式来表示，比如：

[这是一个链接](http)

你也可以使用 [文本][编号] 的格式来表示，然后在文档的末尾添加 [编号]: 网址 来定义链接，比如：

[这也是一个链接](1)

[][1]

8. 图片

要添加图片，你可以使用  的格式来表示，你也可以使用 ![文本][编号] 的格式来表示，然后在文档的末尾添加 [编号]: 网址 来定义图片，比如：

 ![这也是一张图片][2]

9. 引用

要添加引用，你可以使用 > 来表示引用的内容，比如：

>这是一段引用的内容