Markdown基本语法教程

前言

写这篇教程的目的呢，其一想帮助到准备使用Markdown，但还不了解Markdown语法的人，其二是练习一下，加深一下我对Markdown语法的记忆，实不相瞒，这篇文章就是我第一次使用Markdown语法所作。

先简单介绍一下Markdown吧，它是轻量级标记语言、语法简洁、纯文本、可与HTML混编、在AI对话中经常被使用。

标题语法

要创建标题，只需在文字前添加井号(#)。# 的数量代表了标题的级别，最多可添加到六级标题。
*注意：为了保证兼容性，请在#和标题之间使用空格进行分割*
预览如下：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

对应的语法代码如下 

1
2
3
4
5
6
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

段落语法

使用空白行将一行或多行文本进行分隔，就是我们所说的回车键，在每个段落之间使用一个回车键。

*注意：不要用空格（spaces）或制表符（ tab）缩进段落。*

预览如下：
这是第一段

这是第二段

对应的语法代码如下： 

1
2
3
这是第一段

这是第二段

换行语法

在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行。
*tips:虽然我也不知道为啥要加空格，但官方文档里说要加两个以上空格，可能是为了兼容性，知道的小伙伴可以评论区留言。*

预览如下：
时光匆匆流逝，但每一刻都值得被温柔对待，无论静谧还是喧嚣，都让我心动不已。
心中有光的人，终会冲破一切黑暗和荆棘。你不必逞强，时间会为你疗伤。

对应的语法代码如下： 

1
2
时光匆匆流逝，但每一刻都值得被温柔对待，无论静谧还是喧嚣，都让我心动不已。  
心中有光的人，终会冲破一切黑暗和荆棘。你不必逞强，时间会为你疗伤。

强调语法

通过将文本设置为粗体或斜体来强调其重要性。

预览如下：
粗体
斜体
又粗又斜

对应的语法代码如下

1
2
3
**粗体**  
*斜体*
***又粗又斜***

引用语法

要创建块引用，请在段落前添加一个>符号。

预览如下：

主动的人，和命运一起走，被动的人，命运推着你走。前者有一半的胜算，后者只能听凭命运的摆布。

大丈夫处世，当扫除天下，安事一室乎？——汉·陈蕃

君子之交淡如水，小人之交甘若醴。——《庄子》

生当作人杰，死亦为鬼雄。——宋·李清照《夏日绝句》

风声、雨声、读书声，声声入耳；家事、国事、天下事，事事关心。——明·顾宪成

书山有路勤为径，学海无涯苦作舟。——《增广贤文》

对应的语法代码如下： 

1
2
3
4
5
6
7
8
9
10
11
> 主动的人，和命运一起走，被动的人，命运推着你走。前者有一半的胜算，后者只能听凭命运的摆布。  

> 大丈夫处世，当扫除天下，安事一室乎？——汉·陈蕃
>
> 君子之交淡如水，小人之交甘若醴。——《庄子》

> 生当作人杰，死亦为鬼雄。——宋·李清照《夏日绝句》
>
> 风声、雨声、读书声，声声入耳；家事、国事、天下事，事事关心。——明·顾宪成
>
>> 书山有路勤为径，学海无涯苦作舟。——《增广贤文》

列表语法

可以将多个条目组织成有序或无序列表。

有序列表

在每个表项前加一个数字和英文句点，即可组成有数字顺序的列表，数字不必按数学顺序排列，但都必须从1开始，缩进一个(四个空格)或多个列表项可创建嵌套列表。

预览如下：

  1. 这是第一条
  2. 这是第二条
  3. 这是第三条
  1. 这是第一条
  2. 这是第二条
  3. 这是第三条
  1. 这是第一条
    1. 这是第一条的第一条
    2. 这是第一条的第二条
  2. 这是第二条

对应的语法代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
1. 这是第一条
2. 这是第二条
3. 这是第三条

---

1. 这是第一条
5. 这是第二条
8. 这是第三条

---

1. 这是第一条
    1. 这是第一条的第一条
    9. 这是第一条的第二条
1. 这是第二条

无序列表

在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

预览如下：

  • 无序列表第一条
  • 无序列表第二条
  • 无序列表第三条
  • 无序列表第一条
  • 无序列表第二条
  • 无序列表第三条
  • 无序列表第四条

对应的语法代码如下：

1
2
3
4
5
6
7
8
9
10
* 无序列表第一条
* 无序列表第二条
* 无序列表第三条

---

* 无序列表第一条
+ 无序列表第二条
- 无序列表第三条
- 无序列表第四条

代码语法

要将单词或短语表示为代码，请将其包裹在反引号 ( `) 中。

*tips:反引号在键盘上的位置在ESC键下方。*

预览如下：
Are you OK?

1
2
这是另一种代码块写法。
Are you OK?

对应的语法代码如下：

1
2
3
4
5
6
7
8
`Are you OK?`

---

```Markdown
这是另一种代码块写法。
Are you OK?
\`\`\`

分割线语法

在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容。

链接语法

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。

预览如下：

后面的文字是个链接可以点击Markdown语法官网文档。
然后是带title的，鼠标放上去可显示文字Markdown语法官网文档。

对应的语法代码如下：

1
2
后面的文字是个链接可以点击[Markdown语法官网文档](https://markdown.com.cn)。  
然后是带title的，鼠标放上去可显示文字[Markdown语法官网文档](https://markdown.com.cn "最好的markdown教程")。

图片语法

要添加图像，请使用感叹号 (!), 然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后的图片title可删除。
插入图片Markdown语法代码：![图片alt](图片链接 "图片title")。

表格示例

功能 状态 说明
本地搜索 ✅ 已完成
主题配置 ✅ 已完成
评论功能 ✅ 已完成 
1
2
3
4
5
| 功能 | 状态 | 说明 |
|------|------|------|
| 本地搜索 | ✅ | 已完成 |
| 主题配置 | ✅ | 已完成 |
| 评论功能 | ✅ | 已完成 |

结语

  • 呼！终于写完了，这算是这个博客建成以来的第一篇正式的文章了，以前从来没写过这么长的东西，希望以后能坚持下去。本篇文章还有不足之处请多多包涵，更详细的内容可以查看官方文档。