MarkDown基础语法

---

布局：markdown
标题：MarkDown基本语法
日期：2018-04-19 16:10:48

标签：MarkDown Grammr

序言

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

起因

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

正文

一、标题

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

方法一：

代码：

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

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

方法二：

代码：

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

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

方法三：

代码：

一级标题
===
二级标题
--- 

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

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

二、列表

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

1、无序列表

代码：

* 1
* 2
* 3
+ 1
+ 2
+ 3
- 1
- 2
- 3

显示效果：

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

2、有序列表

代码：

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，嵌套使用：

代码：

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

显示效果：

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

四、分割线

代码：

分割线1
***
分割线2
---
分割线3
___

显示效果：

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

五、超链接

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

1、行内式：

代码：

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

显示效果：

请点击：百度链接。
请点击：百度链接。

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

2、参考式：

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

代码：

我经常去的网站[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是一个不错的开原网站。

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

六、自动连接

代码：

<http://wwww.baidu.com>
<[e-mail]>

显示效果：

http://wwww.baidu.com
[email protected]

语法说明： Markdown支持以下简短的自动链接形式来处理网址和电子邮件信箱，只要是<>包起来，Markdown就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

七、插入图片

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

1、行内式

夏椅：
！[百度]（http://yoocii.cn/2018/04/19/Grammar/picture.png）

显示效果：

语法说明：

！[图片Alt]（图片地址“图片标题“）

2、参考式代码：

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

显示效果：

夏椅：

语法说明：

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

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

八、表格

1、简单方式

代码：

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

显示效果：

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

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

2、原生方式

代码：

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

显示效果：

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

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

3、表格对其方向

用户姓名|用户性别|用户身高
- ：| - ：| - ：
小明|男|178厘米
小红|女|167厘米
小强|男|180厘米

显示效果：

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

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

九、代码框

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

1、单行展示

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

代码：

`请点击：[百度（http://www.baidu.com）链接.` 

显示效果：

请点击：[百度（http://www.baidu.com）链接。

注意：。这里是反单引号并不是单引号

2、行多展示

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

```
降价请点击：[ 百度]（http://www.baidu.com ）链接。请点击：[ 百度]（http://www.baidu.com“百度” ）链接```

显示效果：

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

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

十、强调

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

代码：

*字体倾斜*
_字体倾斜_
**字体加粗**
__字体加粗__
***字体倾斜并加粗***
___字体倾斜并加粗___

显示效果：

字体倾斜
字体倾斜
字体加粗
字体加粗
字体倾斜并加粗
字体倾斜并加粗

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

十一、转义

代码：

\\
\〜
\
\
\ \ \ _
\  -
\ +
\。
\！

显示效果：
\
~
`
*
_
-
+
.
!

语法说明：就不一一列举了，基本上跟js转义是一样的。

十二、空格及换行

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

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