## **Markdown 基本语法教程**
*本文所有资料来源于 [Markdown语法教程](https://markdown.com.cn/basic-syntax/ "前往访问"), 里面资料更全,这里只是做一个简单的整理与实践,方便快速入门,详细资料请去原链。*
### **1. 标题语法**
要创建标题,请在单词或短语前面添加井号 (#) 。# 的数量代表了标题的级别。
例如,添加三个 # 表示创建一个三级标题
~~~
### 我的头
~~~
>### 我的头
---
### **2. 段落语法**
要创建段落,请使用空白行将一行或多行文本进行分隔。
~~~
第一行 接下来空一行
第二行
~~~
>第一行 接下来空一行
>
>第二行
---
### **3. 换行语法**
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行(\<br>)。
~~~
这行后面有两个空格 然后回车
~~~
>这行后面有两个空格,然后回车
>
>
>看到上面换行了
---
### **4. 强调语法**
* 粗体
要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)。
如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)。
~~~
Never **made** it as a __wise__ man.
~~~
>Never **made** it as a __wise__ man.
* 斜体
要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。
要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。
~~~
Never *made* it as a _wise_ man.
~~~
>Never *made* it as a _wise_ man.
* 粗体和斜体
要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。
---
### **5. 引用语法**
要创建块引用,请在段落前添加一个 > 符号。
块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。
~~~
>Never made it as a wise man
>I couldn't cut it as a poor man stealing
>>Tired of living like a blind man
>>I'm sick of sight without a sense of feeling
~~~
>Never made it as a wise man
>I couldn't cut it as a poor man stealing
>>Tired of living like a blind man
>>I'm sick of sight without a sense of feeling
---
### **6. 列表语法**
* 有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
~~~
1. wise man
3. poor man
2. blind man
1. eye
1. heart
4. sick man
~~~
>1. wise man
>3. poor man
>2. blind man
> 1. eye
> 1. heart
>4. sick man
* 无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。
缩进一个或多个列表项可创建嵌套列表。
~~~
* wise man
* poor man
* blind man
* eye
* heart
* sick man
~~~
>* wise man
>* poor man
>* blind man
> * eye
> * heart
>* sick man
---
### **7. 代码语法**
* 要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。
~~~
Never made it as a `wise man`
~~~
>Never made it as a `wise man`
>>反引号在键盘左上,数字1键的左边,Esc键的下方。
* 代码块
要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。
~~~
import tensorflow as tf
logo = 'gugu'
~~~
> import tensorflow as tf
> logo = 'gugu'
* 围栏代码块
在代码块之前和之后的行上使用三个反引号((```)或三个波浪号(~~~)。
~~~
```python
import tensorflow as tf
logo = 'gugu'
```
~~~
效果如下:
>~~~python
>import tensorflow as tf
>logo = 'gugu'
>~~~
---
### **8. 分隔线语法**
要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。
为了兼容性,请在分隔线的前后均添加空白行。
```
wise man
***
poor man
---
blind man
___
```
>wise man
>
>***
>
>poor man
>
>---
>
>blind man
>
>___
---
### **9. 链接语法**
* 通用链接
链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
超链接Markdown语法代码:`[超链接显示名](超链接地址 "超链接title")`
```
这是一个链接 [Py学习](https://www.kancloud.cn/chinabiue/asfe/2032564 "这是可选的title")
```
> 这是一个链接 [Py学习](https://www.kancloud.cn/chinabiue/asfe/2032564 "这是可选的title")
* 网址和Email地址
使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
~~~
<https://www.kancloud.cn/chinabiue/asfe/2032564>
<BET@bet.com>
~~~
><https://www.kancloud.cn/chinabiue/asfe/2032564>
><BET@bet.com>
---
### **10. 图片语法**
要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码:`![图片alt](图片链接 "图片title")`。
~~~
![这是图片](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan")
~~~
>![这是图片](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan")
* 链接图片
给图片增加链接,请将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。
~~~
[![大嘴鸟](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan")](https://www.kancloud.cn/chinabiue/asfe/2032564)
~~~
> [![大嘴鸟](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan")](https://www.kancloud.cn/chinabiue/asfe/2032564)
---
### **11. 转义字符语法**
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 () 。
~~~
\* Without the backslash, this would be a bullet in an unordered list.
~~~
>\* Without the backslash, this would be a bullet in an unordered list.