MarkDown 基本语法

发表于

序言

       有想查看markdown编写出的程序代码标签转化为html标签的可以点击markdown在线编辑,这是网上一个很好用的在线翻译工具。

起因

       Markdown流行起来就是因为它简单。更容易理解的解释是，当你想快速写篇丰富格式且又美观的文章或论文，却又不想打开Word时，你可以用Markdown，手不离键盘，快速高效。

正文

一、标题

       标题是真是文章的开始，也是目录生成的标志。标题下面是几种编写标题的语法：

方法一：

代码：

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

注意：#后面跟上空格,在编写markdown标签时建议使用方法。

方法二：

代码：

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

注意：与方法一相比，次方法#可以不跟空格，不过为了标签统一性，养成良好的编码习惯，建议加上空格。

方法三：

代码：

1
2
3
4
一级标题
===
二级标题
---

注意：这种方法好像只能表示一级和二级标题，而且=和-号的数量没有限制，只要大于一个就行，但是还是为了编码的一直性建议采用三个。

显示效果：

标题
注意： 方法一与方法二标题支持h1-h6,方法三只支持一级标题和二级标题。另外这三种方式的标题可以混合使用，但是为了让页面标签的统一性，不建议混合使用，还是推荐使用第一种。

二、列表

我们都知道，列表分为有序列表和无序列表，下面主要介绍这两种列表的写法。

1、无序列表

代码：

1
2
3
4
5
6
7
8
9
* 1
* 2
* 3
+ 1
+ 2
+ 3
- 1
- 2
- 3

显示效果：

无序列表
语法说明：无序列表可以用（星号、加号、减号）来创建的效果都是一样的，用兴趣的用序言推荐的markdown在线编辑器，可以发现实际上是都转换成了ul>li ，所以使用哪个都可以，推荐使用* 。

2、有序列表

代码：

1
2
3
4
5
1. 列表1
2. 列表2
3. 列表3
2. 列表4
1. 列表5

显示效果：

无序列表
语法说明：有序列表就相对简单一点，只用1.2.3.就可以实现。
注意：数字后面的点只能是英文的点，特别注意，有序了列表的顺序是根据第一行数字顺序来的 ，对比代码与图形可以看出，代码部分序列排序为1.2.3.2.1.而运行结果图为1.2.3.4.5.，可以看出，列表的顺序是按第一行排序，这点必须注意了。

三、块引用

对某个部分的内容一些说明或者引用了somebody的话，作品的作者等，可以用区块引用。

1、嵌套引用：

代码：

1
2
3
4
5
6
7
>一级引用
>>二级引用
>>>三级引用
>>>>四级引用
>>>>>五级引用
>>>>>>六级引用
>>>>>>>七级引用

显示效果：

嵌套引用
语法说明：想要在上一层引用中嵌套一层引用，只需要多家一个 > ，理论上可以无限嵌套。
注意：多层嵌套的 > 是不需要连续在一起的，只要在一行就可以了，中间允许有空格，但是为了好看，建议多层嵌套时控制在一起写。

1、嵌套使用：

代码：

1
2
3
4
5
> ## 名言
> * 真理惟一可靠的标准就是永远自相符合。
> >                            ------ 欧文
> * 时间是一切财富中最宝贵的财富。
> >                            ------ 德奥弗拉斯多

显示效果：

嵌套使用

可以看出标题也可以嵌套在引用中，具体的使用很简单，多写几遍就掌握了。

四、分割线

代码：

1
2
3
4
5
6
分割线1
***
分割线2
---
分割线3
___

显示效果：

分割线
语法说明：分割线可以由(星号，减号，底线）这3个符号的至少3个符号表示，建议用-（减号）。
注意： 至少要三个，且不需要连续，有空格也可以。

五、超链接

MarkDown支持两种形式的链接语法，行内式链接和参考式两种，行内式一般使用较多。

1、行内式：

代码：

1
2
请点击：[百度](http://www.baidu.com)链接。
请点击：[百度](http://www.baidu.com "百度")链接。

显示效果：

请点击：百度链接。
请点击：百度链接。
语法说明：[ ]这里写链接文字,（）这里写链接地址,（）中的””中可以为链接指定title的属性，title属性可以不加。title属性的效果是鼠标悬停在连接上会出现制定的title文字。[链接文字]（链接地址 ”链接标题“）这样的形式。
注意：链接地址与链接标题前有个空格。链接标题要有英文模式下的””（引号）。

2、参考式：

参考式超链接一般用在学术论文上面，或者另一种情况，如果某一个链接在文章中多处使用，那么使用引用的方式创建链接将非常好，它可以让你对链接进行统一的管理。

代码：

1
2
3
4
5
我经常去的网站[Google][1]、[百度][2]以及[github][3]，[github][3]是一个不错的开原网站。

[1]:http://wwww.google.com "Google链接"
[2]:http://wwww.baidu.com "百度链接"
[3]:https://github.com/ "github链接"

显示效果：

我经常去的网站Google、百度以及github，github是一个不错的开原网站。

语法说明：参考式链接分为两部分，文中的写法 [链接文字][链接标记]，在文本的任意位置添加[链接标记]:链接地址 “链接标题”，链接地址与链接标题前有一个空格。
注意：以上代码符号均用英文输入法写入。如果链接文字本身可以做为链接标记，你也可以写成[链接文字][ ]。

六、自动连接

代码：

1
2
<http://wwww.baidu.com>
<address@exaple.com>

显示效果：

http://wwww.baidu.com>
address@exaple.com
语法说明：Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用< >包起来，Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

七、插入图片

图片的创建方式与超链接相似，而且和超链接一样也有两种写法，行内式和参考式写法。

1、行内式

1
2
夏椅：
![百度](http://yoocii.cn/2018/04/19/Grammar/picture.png)

显示效果：

夏椅
语法说明：

1
![图片Alt](图片地址 “图片Title”)

2、参考式

代码：

1
2
3
夏椅：
![夏椅][desk]
[desk]:http://yoocii.cn/2018/04/19/Grammar/picture.png "夏椅"

显示效果：

夏椅：
![夏椅][desk]
[desk]:http://yoocii.cn/2018/04/19/Grammar/picture.png “夏椅”

语法说明：

1
在文档要插入图片的地方写![图片Alt][标记]在文档的最后写上[标记]:图片地址 “Title”

注意：语法中图片Alt的意思是如果图片因为某些原因不能显示，就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样，表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的，可以省略，但建议写上。

八、表格

1、简单方式

代码：

1
2
3
4
5
用户姓名|用户性别|用户身高
-|-|-
小明|男|178cm
小红|女|167cm
小强|男|180cm

显示效果：

用户姓名 用户性别 用户身高
小明 男 178cm
小红 女 167cm
小强 男 180cm

语法说明：第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。

2、原生方式

代码：

1
2
3
4
5
|用户姓名|用户性别|用户身高|
|-|-|-|
|小明|男|178cm|
|小红|女|167cm|
|小强|男|180cm|

显示效果：

用户姓名 用户性别 用户身高
小明 男 178cm
小红 女 167cm
小强 男 180cm

语法说明：比简单方式多加了两边的边框，其他都一样，第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。

3、表格对其方向

1
2
3
4
5
用户姓名|用户性别|用户身高
-:|-:|-:
小明|男|178cm
小红|女|167cm
小强|男|180cm

显示效果：

用户姓名 用户性别 用户身高
小明 男 178cm
小红 女 167cm
小强 男 180cm

语法说明第二行可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就右对齐。
注意：:(冒号)为英文输入法模式下符号，可以单列使用，使用方式在第二行所选列的-（减号）后面加:(冒号)。

九、代码框

这个就比较重要了，很多时候都需要展示出一些代码可以用代码框。

1、单行展示

如果代码量比较少，只有单行的话，可以用单反引号包起来。

代码：

1
`请点击：[百度](http://www.baidu.com)链接。`

显示效果：
请点击：[百度](http://www.baidu.com)链接。
注意：这里是反单引号并不是单引号。

2、多行展示

要是多行这个就不行了，多行可以用三个反引号，如果要写注释，可以在反引号后面写。

代码：

1
2
3
4
``` markdown
请点击：[百度](http://www.baidu.com)链接。
请点击：[百度](http://www.baidu.com "百度")链接
```

显示效果：

1
2
请点击：[百度](http://www.baidu.com)链接。
请点击：[百度](http://www.baidu.com "百度")链接

注意：如果要写注释，可以在反引号后面写。

十、强调

强调包括字体倾斜、字体加粗等。

代码：

1
2
3
4
5
6
*字体倾斜*
_字体倾斜_
**字体加粗**
__字体加粗__
***字体倾斜并加粗***
___字体倾斜并加粗___

显示效果：

字体倾斜
字体倾斜
字体加粗
字体加粗
字体倾斜并加粗
字体倾斜并加粗
语法说明：一个星号或者是一个下划线包起来，会转换为< em >倾斜，如果是2个，会转换为< strong >加粗，如果是三个就是倾斜并加粗。

十一、转义

代码：

1
2
3
4
5
6
7
8
9
\\
\~
\`
\*
\_
\-
\+
\.
\!

显示效果：
\
~
`
*
_
-
+
.
!
语法说明：就不一一列举了，基本上跟js转义是一样的。

十二、空格及换行

半方大的空白 或 
全方大的空白 或 
不断行的空白格 或 

注意：当不能换行时可以采用先输入空格后再跟回车进行换行。