Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。 相比于富文本编辑器那复杂的代码量,Markdown的标记语法简单很多,基本上几分钟就可以学会。下面简单介绍下Markdown的标签含义。
一、标题
语法如下:
# 这是一级标题
## 这是二级标题
### 这是三级标题(本文章的标题 “一、标题” 使用的3级标题)
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题(最多支持6级标题)
二、字体
语法如下:
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
效果如下:
这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字
这是加删除线的文字
三、引用
语法如下:
>这是一级引用的内容
>>这是二级引用的内容
>>>这是三级引用的内容
效果如下:
这是一级引用的内容
这是二级引用的内容
这是三级引用的内容
四、分割线
语法如下:
* * *
***
*****
- - -
-----------
解释:
用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格。
分割线使用时,注意和前面的正文之间要隔空一行。
不然不仅不会起效,而且还为将前面正文样式改变(似乎变成了标题)
效果如下:
五、图片
语法如下:
![这里是图片的注释](这里是图片的地址)
例:
![图片标题](https://upload-images.jianshu.io/upload_images/23466769-8e9bce46f378d365.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/300)
注意:
部分url里面可以设置图片大小,此案例的的图片url最后面的数字300表示图片宽度为300像素。
效果如图:
六、超链接
语法如下:
[中括号内是要加超链接的文本](小括号放链接地址)
例:
[孙思锴的博客](https://sunsikai.github.io/)
效果:孙思锴的博客
七、无序列表
语法:
- 列表内容
+ 列表内容
* 列表内容
注意:
无序列表用 - + * 任何一种都可以,- + * 跟内容之间都要有一个空格
效果:
- 列表内容(-)
- 列表内容(+)
- 列表内容(*)
八、有序列表
语法:
1. 列表内容
2. 列表内容
3. 列表内容
注意:
列内容前面的数字后面要加一点和空格。
效果: 1. 列表内容 2. 列表内容 3. 列表内容
九、列表嵌套
语法:
1. 一级有序内容
- 二级无序内容
- 二级无序内容
- 三级列表内容
2. 二级有序内容
4. 有序列表内容
1. 有序列表内容
2. 有序列表内容
注意:
次级和上一级之间,在次级内容前面在敲三个或以上的空格即可。
在所有次级的有序列表内容的编号排序,都由次级列表中第一个列表内容的数字序号决定。
如,尽管我们在次级有序列表里面定义的序号是4,6,7还是4,1,2,页面效果排序都会从4开始(4,5,6)。
效果:
- 一级有序内容
- 二级无序内容
- 二级无序内容
- 三级列表内容
- 二级有序内容
- 列表内容
- 列表内容
- 列表内容
十、表格
语法:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
解释:
第二行分割表头和内容。- 有一个即可,为了对齐,这里多加了
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注意:表格使用前需要和前面的内容隔开一行,否则会识别失败
效果:
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
十一、代码
语法:
单行代码:代码之间分别用一个反引号(`)包起来
多行代码:代码行上下两行分别使用三个反引号(```)包起来
例:
(```)
这是多行代码写法
这是多行代码写法
(```)
(`)这是单行代码写法(`)
解释:
例子里面为了效果显示,我将反引号用小括号括起来防止错出。
效果:
这是单行代码的显示效果
这是多行代码的显示效果
这是多行代码的显示效果
十一、markdown注释(这一条似乎没什么用)
语法:
[//]: # (哈哈我是最强注释,不会在浏览器中显示。)
[^_^]: # (哈哈我是最萌注释,不会在浏览器中显示。)
[//]: <> (哈哈我是注释,不会在浏览器中显示。)
[comment]: <> (哈哈我是注释,不会在浏览器中显示。)
十二、代码及代码块
语法:
单行代码:代码之间分别用一个反引号(`)包起来
多行代码:代码行上下两行分别使用三个反引号(```)包起来
例:
(```)
这是多行代码写法
这是多行代码写法
(```)
(`)这是单行代码写法(`)
解释:
例子里面为了效果显示,我将反引号用小括号括起来防止错出。
效果:
这是单行代码的显示效果
这是多行代码的显示效果
这是多行代码的显示效果
十三、换行
解释:
段落换行时,记得要在段落的最后面加上两个空格,再进行回车换行。
如果上一段落结束后没有多加两个空格,在部分情况下回车换行是不会有效果的。
十四、注意事项
使用Markdown标签时,需要严格遵守语法规定,如部分标签(表格、分隔线)使用前需要先和前面的内容隔空一行。如果没遵循语法使用,可能会出现Markdown标签在部分平台编译不成功的情况。这是由于各家平台使用的解释器可能不一样导致的。 例:分割线标签使用时,如没和前边的内容隔空个一行,该标签在简书平台上可以正常使用,而在部分博客(jekyll)上会识别不出来。 如果大家在使用过程中遇到标签失效的情况,可以先将该标签使用的内容和前面的内容用换行符隔开几行试试。
本文章内容参考来源如下: