Markdown语法

Markdown语法介绍

Markdown 是一种方便记忆、书写的纯文本标记语言，用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档：譬如您正在阅读的这份文档。它使用简单的符号标记不同的标题，分割不同的段落，粗体 或者 斜体 某些文字

用途

Markdown的语法简洁明了、学习容易，而且功能比纯文本更强，因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如Joomla、Drupal都能很好的支持Markdown。

---

Markdown语法运用

1.标题：

标题能显示出文章的结构。行首插入1-6个 # ，每增加一个 # 表示更深入层次的内容，对应到标题的深度由 h1-h6 阶写法(依次对应HTML的h1-h6标签)：

h1 ： # 一级标题
h2 ： ## 二级标题
h3 ： ### 三级标题
h4 ： #### 四级标题
h5 ： ##### 五级标题
h6 ： ###### 六级标题

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

首行插入1-6个#号，代表更深入层次的内容有时候为了美观，也可以这样进行输入。

h1 = # 一级标题 #

注:#号和标题之间要＋空格

2.分级标题

写法：

一级标题
=======
二级标题
---------
注：=、-可以只写一个

效果：

效果

3.文本样式

写法：

链接 :[Title](URL)
加粗 :**Bold**
斜体字 :*Italics*
删除线 :~~text~~
高亮 :==text==
段落 : 段落之间空一行
换行符 : 一行结束时输入两个空格
列表 :* 添加星号成为一个新的列表项。
引用 :> 引用内容
内嵌代码 : 'alert('Hello World');'
画水平线 (HR) :--------

效果：

链接 :Title
加粗 :Bold
斜体字 :Italics
删除线 :text

高亮 :==text==
段落 : 段落之间空一行
换行符 : 一行结束时输入两个空格
列表 :* 添加星号成为一个新的列表项。
引用 :> 引用内容
内嵌代码 : 'alert('Hello World');'
画水平线 (HR) :--------

4.超链接

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

4.1.行内式

写法：

欢迎来使用[谷歌搜索](https://www.google.com/)
效果：
欢迎来使用谷歌搜索

4.2.参考式

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

我经常去几个网站谷歌、百度以及自己的
文字和链接中间要空一行

```[1]:https://www.google.com/ "google"```
```[2]:https://www.baidu.com/   "baidu"```
```[3]:https://www.jianshu.com/ "fanmucc"```

效果：

我经常去几个网站谷歌、百度以及自己的

4.3.自动链接

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

写法：

效果:

https://www.google.com/
https://www.baidu.com/

5.表格

注意: 代表对齐方式 ,** : 与 | 之间不要有空格**，否则对齐会有些不兼容，同样表格与上一行内容需要用回车保持一行的间隔，不然在运行后会出现双表格（两个一摸一样的表格）。
写法以及效果：

| 年级 | 姓名 | 性别 |
|:----:|:----|----:|
|一年级 |张三| 男|
|============|=======|========|

年级	姓名	性别
一年级	张三	男
===========	==========	===========

效果：

年级	姓名	性别
一年级	张三	男
===========	==========	===========

注:||之间没有空格限制，不需要刻意对其。

6.列表

6.1 无序列表

无序列表使用星号、加号和减号来做为列表的项目标记，这些符号是都可以使用的，使用星号。
写法：

星号:
* 字体1
* 字体2
* 字体3
加号：
+ 字体4
+ 字体5

+ 字体6

减号:
- 字体7
- 字体8
- 字体9

效果：

星号：

• 字体1
• 字体2
• 字体3

加号:

• 字体4
• 字体5
• 字体6

减号:

• 字体7
• 字体8
• 字体9

6.2 有序列表

有序的列表则是使用一般的数字接着一个英文句点作为项目标记。
写法：

1.张三
2.张四
3.张五

效果：

1.张三
2.张四
3.张五

7.图片

引入图片有两种方式，分别是行内式和参考式。参考式有利于链接的管理

7.1 行内式

写法：

![图片Alt](图片链接)
![示例](https://i.loli.net/2018/04/17/5ad5ada434e90.png)

效果：

示例

7.2 参考式

写法：

![示例][photo]
两者之间需要空一行
[photo]:图片链接
![示例][photo]
两者之间需要空一行
[photo]:![示例](http://upload-images.jianshu.io/upload_images/11461186-389f3294c0d04b98.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果：

示例

8.代码

一种是利用缩进(Tab), 另一种是利用”`”符号（一般在ESC键下方）包裹代码。

8.1 行内式代码

写法：

前端怎么使用`

`标签;

效果：

前端怎么使用

标签

8.2 缩进多行代码

缩进 4 个空格或是 1 个制表符
一个代码区块会一直持续到没有缩进的那一行（或是文件结尾
写法：

效果：

8.3.代码标记块

写法：

```

你好

```

效果：

你好

9.分割线

在markdown语法中,一行连用三个或者三个以上的星号,减号,或者下划线,就可以表示分割线.
例如:***; ---;___

效果：
***

---

---

___

---

本文章会长期进行更新

---

注：关于用Markdown语法上传到Github上乱码问题

本人测试将在本地仓库写的.md文件上传到github上出现乱码，并且将字符编码保存为utf-8，同样也出现问题。

github项目截图

3个.md文件，只有第一个README.md文件没有形成乱码，后来查找发现自己其中两个文件命名错误，导致上传后出现乱码。
github上的.md文件一定要命名为README.md，希望大家在以后不要像我一样粗心大意。