概述
理解Markdown的基本语法规则,不同编辑器支持的语法规则有部分差异。
标题
在文本前面添加#,用于表示标题,#数量代表不同的标题等级,至多可以有6个#。
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
Markdown | HTML |
---|---|
# 一级标题 | <h1>一级标题</h1> |
## 二级标题 | <h2>二级标题</h2> |
### 三级标题 | <h2>三级标题</h3> |
#### 四级标题 | <h2>四级标题</h4> |
##### 五级标题 | <h2>五级标题</h5> |
###### 六级标题 | <h2>六级标题</h6> |
替代语法
也可以在文本下方添加若干“=”表示一级标题,添加若“-”-表示二级标题
一级标题
一级标题
=
二级标题
二级标题
-
段落
在Markdown中,默认回车不表示换行,必须使用空白行分割两个段落。
段落一
段落二
段落一
段落二
段落一
段落二
段落一
段落二
换行符
创建换行符(<br>),在末尾添加两个或者多个空格,然后输入回车。换行表示文本在一个段落内。
第一行
第二行
文本斜体
要斜体显示文本,请在单词或短语前后添加一个星号(*)或下划线(_)。使用下划线时需要添加空格。
文本斜体。
1 | 文本*斜体*。 |
文本 _斜体_。
1 | 文本 _斜体_。 |
文本粗体
要加粗文本,请在单词或短语的前后添加两个星号(*)或下划线(_)。使用下划线时需要添加空格。
文本加粗。
1 | 文本**加粗**。 |
文本 加粗。
1 | 文本 __加粗__。 |
文本斜体加粗
要同时突出显示带有粗体和斜体的文本,请在单词或短语的前后添加三个星号(***)或下划线(___)。
文本斜体加粗。
1 | 文本***斜体加粗***。 |
文本 斜体加粗。
1 | 文本___斜体加粗___。 |
引用
使用“>”创建引用块。
这是引用内容。
1 | >这是引用内容。 |
多行引用需要在每行前面添加“>”。
引用第一行
引用第三行
1 | >引用第一行 |
引用得嵌套
引用可以做嵌套,每多一个“>”表示一层嵌套。
0
1
2
3
4
5
6
7
8
9
1 | >0 |
具有其他元素得块引用
在块引用中可以使用其他的语法。
三级标题
列表1
列表2
文本斜体与加粗
有序列表
要创建有序列表,在列表项中添加数字和句点。数字不必按数字顺序排列,但列表应以数字开头。
列表排序按照列表的一个序号开始。每个列表还可以嵌套列表
- 此列表以3开始,
- 并且语法中的列表编号,不代表列表的顺序编号,
- 这是个嵌套列表,
- 语法原则相同,
- 注意代码中的序号。
1 | 3. 此列表以3开始, |
无序列表
创建无序列表,在列表项前面添加破折号(-),星号(*)或加号(+)。同样可以做无序列表的嵌套。
- 无序列表项一
- 无序列表项二
- 嵌套无序列表
- 嵌套无序列表二
- 嵌套无序列表三
- 嵌套无序列表
- 无序列表项
1
2
3
4
5
6- 无序列表项一
* 无序列表项二
* 嵌套无序列表
- 嵌套无序列表二
* 嵌套无序列表三
+ 无序列表项
要在保留列表连续性的同时在列表中添加另一个元素,使用缩进四个空格或一个制表符。可以使用其他语法规则在列表中。
- 无序列表项一
无序列表项二
保持列表*格式*
引用
无序列表项三
1
2
3
4
5
6
7* 无序列表项一
+ 无序列表项二
保持**列表***格式*
>引用
+ 无序列表项三
代码
要将单词或短语表示为代码,使用反引号(`)。代码一般会被高亮显示。
在Python中open(file, mode='r')
表示打开一个文件。
1 | 在Python中`open(file, mode='r')`表示打开一个文件。 |
转义符
要想表示字符的本来含义,在字符前面添加反斜杠(\)。
打印一个*再打印一个*.
打印一个再打印一个.
注意以上代码区别。
1 | 打印一个\*再打印一个\*. |
代码块
要创建代码块,请在代码块的每一行缩进至少四个空格或一个制表符。效果等同意使用三个反引号(`)
<html>
<head>
<title>Test</title>
</head>
水平分割符
创建水平分割符,在一行上使用三个或更多星号(***),破折号(—)或下划线(___)。
1 | *** |
连接
创建链接使用基本语法[连接文本](连接地址)
。
打开谷歌。
1 | 打开[谷歌](https://www.google.com)。 |
添加标题
以上代码在鼠标指向文本后,默认显示连接地址,要想替换成其他文本内容,使用以下语法[连接文本](连接地址 “连接描述”)
打开谷歌。
1 | 打开[谷歌](https://www.google.com "打开谷歌")。 |
URL与Email
要标识一个URL或者Email,使用”<>“。
1 | <https://skmonet.com> |
图片
在文本中插入图片使用语法![图片说明](图片地址 ”图片描述“)
。
”图片地址“可以是本地(可以使用相对路径)或者图床地址。
”图片描述“是在鼠标指向图片时显示的一段文字,为可选参数。
1 | ![小花](https://live.staticflickr.com/65535/49741425543_00e837e3e5_q.jpg "我是小花") |
图片连接
为图片增加连接实际上就是连接与图片语法的结合:[![图片说明](图片地址 ”图片描述“)](连接地址)
1 | [![xiaohua](https://live.staticflickr.com/65535/49764455253_e14fcba4ba_q.jpg "xiaohua")](https://skmonet.com) |
HTML
在Markdown中,支持插入HTM语法,例如修改文本字号,颜色等。
在Markdown中,没有修改文本颜色的语法,但是可以使用HTMl改变文本颜色、字号等,也可以实现文本加粗与倾斜。