1、段落与换行
Markdown 中的段落指连续的一段文字,编写时段落之间用至少一个空行隔开,段落内多个空格将被视为一个空格,段首不支持缩进。
如果想要在显示时显示多个空行,可以插入
来实现,注意的是,插的
应与前后的段落中间至少空一行。
2、标题
Markdown 支持两种类型的标题。
类型 1 是在标题下面插入 = 或者 - 来标识标题等级,但局限是其只能表示两个级别的标题。
类型 2 是在标题前面插入 1 - 6 个 # ,表示 6 个等级的标题,这是比较推荐的用法。
这是一级标题
========
这是二级标题
这是一级标题
这是二级标题
...
这是六级标题
3、引用
Markdown 中使用 > 来引用。我们可以在一段文字中的每行开头加上 > 来表示一段引用文字,也可以只在一段文字的开头插入一个 > 来表示,如下面的 1、2 两种方式:
//方式 1
这是一句话
这是第二句话
//方式 2
这是一句话
这是第二句话
Markdown 支持使用不同数量的 > 表示嵌套引用。
这是外层的引用
这是内层的引用
4、无序列表
无序列表使用 -、 + 或 * 来作为标记。
第一项
第二项
第三项
上面的 - 可以用 +、 *替换。需要注意的是,- 等符号与后面的文字至少空一格空格。
5、有序列表
有序列表使用数字和紧挨着的点号表示。
1.第一项
2.第二项
3.第三项
同无序列表一样,标记符号与后面的文字至少空一格空格。但编辑时的数字对显示无影响。
第一项
第二项
第三项
6、代码区块
缩进 4 个空格,需要注意的是,每行代码都需要至少缩进 4 个空格,不能像段落一样采用首行标记的偷懒写法,一个代码区会一直持续到没有缩进 4 个空格的那一行。
也可以用一对三个连续的撇号 ` 来包裹代码段。
code
有的解释器还能根据代码的语言从而给代码加上语法高亮。
function func() {}
7、分割线
使用三个及以上的 *、 - 或 _来表示一个分割线,符号不能混用,符号之间可以插入多个空格。需要注意的是,使用 - 来插入分割线时需要与上一个段落至少空一行,否则 Markdown 会将上一行文字解释为二级标题。
8、表格
表格是 Markdown 比较复杂的一种表示。
| Table | Col1 | Col2 |
| ----- |:----:| ----:|
| Row1 | 1-1 | 1-2 |
| Row2 | 2-1 | 2-2 |
| Row3 | 3-1 | 3-2 |
上面第二行中的点代表对齐方式,分别是默认(居右)、居中、居左。
行内元素
9、超链接
Markdown 中有三种方式实现超链接。
//方式 1
//方式 2
方式 1 较为常用,也可以为链接的文字加上提示文字,只要在括号中超链接加上空格后添加提示内容即可。
方式 2 由链接文字和链接地址组成,不同的是两者均由 [] 包裹。链接地址的格式为:
方括号,里面输入链接地址;
紧接着是一个冒号;
冒号后面至少一个空格;
链接地址;
若有提示文字,空格后用引号或者括号包裹提示文字。
下面是完整示例:
第三种方式是用 <> 来包裹URL。
//方式 3
10、加粗和斜体
Markdown 使用 * 和 _ 来表示粗体和斜体。
//加粗
这是加粗文字
这也是加粗文字
//斜体
这是斜体文字
这也是斜体文字
被偶数个 * 或 _ 包裹的文字显示加粗效果,被奇数个包裹的为倾斜效果。
需要注意的是,* 和 - 要成对出现,不能混合使用,也不能只出现一个。同时,标识符号要与标识的文字紧挨着,符号与符号之间、符号文字之间不能有任何空格。
11、代码
使用 ` (撇号) 来包裹一小段代码。
Hello world.
若想在代码中添加撇号,可以使用多个撇号包裹里面需要添加的撇号,但注意里面的连续的撇号数量不能超过外面的数量。
//显示一个撇号
`
//显示两个撇号
``
12、图片
图片的插入方式跟超链接前两种插入方式类似。
//方式 1
[图片上传失败...(image-572101-1557147727942)]
//方式 2
反斜杠 \
我们经常需要在文章中插入一些特殊符号,而这些符号恰好是前面所讲的标识符号,可以在特殊符号前插入 \ 来直接显示符号,而不让 Markdown 来将其解释为标识符号。
Markdown 支持以下这些符号前插入 \ 而显示其本来样子:
\ 反斜线
` 反引号
- 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
井字号
- 加号
- 减号
. 英文句点
! 惊叹号