一、标题
-
方式一
用任何数量的 = 和 - 置于文字下方,分别表示H1和H2字体
示例:
This is an H1
=========
This is an H2
-------------
效果:
This is an H1
This is an H2
-
方式二
在文字开头加上 “#”,通过“#”数量表示H1H6标题。(一共只有16级标题,1级标题字体最大)
示例:
#This is an H1
##This is an H2
###This is an H3
####This is an H4
#####This is an H5
######This is an H6
效果:
This is an H1
This is an H2
This is an H3
This is an H4
This is an H5
This is an H6
二、区块引用
在每行前或者段落第一行前加上 > 。同时可以嵌套,在需要嵌套的段落前加上多个 > 。
引用中同样可以使用Markdown语法。
示例:
> ## 这是一个标题。
>
> >1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
>>这是一个嵌套
>>>再次嵌套
>
> 给出一些例子代码:
>
> let str: String = "Hello World!"
效果:
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
这是一个嵌套
再次嵌套
给出一些例子代码:
let str: String = "Hello World!"
三、列表
-
无序列表
无序列表使用星号、加号或是减号作为列表标记(*+-)
注:符号和内容指尖需要有空格
示例:
* 列表内容
+ 列表内容
- 列表内容
效果:
- 列表内容
- 列表内容
- 列表内容
-
有序列表
数字后接一个英文句点,不用在意数字序列
注:符号和内容指尖需要有空格
示例:
1. 列表内容
1. 列表内容
1. 列表内容
效果:
- 列表内容
- 列表内容
- 列表内容
四、代码区块
-
单行代码
使用两个反引号(`)符号包含代码,如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段
注:不是单引号而是左上角的ESC下面~中的反引号
示例:
这是一行代码,多了一个反引号 (`)
效果:
这是一行代码,多了一个反引号 (`)
-
多行代码
每行缩进 4 个空格或是 1 个制表符
示例:
这是一段代码
这是一段代码
这是一段代码
效果:
这是一段代码
这是一段代码
这是一段代码
五、分割线
使用三个以上的星号、减号、底线(*-_)来建立一个分隔线,行内可以有空格,但不能有其它字符。
示例:
* * *
***
*****
- - -
---------------------------------------
效果:
六、链接
不管是哪一种,链接文字都是用 [方括号] 来标记。
-
行内式
语法:
[超链接名](超链接地址 "超链接title")
其中 title 可加可不加,若是链接相同主机资源,可以使用相对路径。
示例:
这是[百度](http://www.baidu.com)的链接
效果:
这是百度的链接
-
参考式
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记。
示例:
[百度][1]、[谷歌][2]和[雅虎][3]都可以搜索内容。
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
七、强调
使用星号(*)和底线(_)作为标记强调字词的符号。~作为删除符号
示例:
*这是倾斜的文字*
_这是倾斜的文字_
**这是加粗的文字**
__这是加粗的文字__
***这是斜体加粗的文字***
___这是斜体加粗的文字___
~~这是加删除线的文字~~
效果:
这是倾斜的文字
这是倾斜的文字
这是加粗的文字
这是加粗的文字
这是斜体加粗的文字
这是斜体加粗的文字
这是加删除线的文字
八、图片
和链接相似也分为两种:行内式和参考式
-
行内式
语法:
! [图片替代文字](图片地址 ''图片标题'')
- 一个惊叹号 !
- 接着一个方括号,里面放上图片的替代文字
- 接着一个圆括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
示例:
! [onepiece](https://uploa '海贼王')
效果:
九、表格
语法:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略
示例:
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |