markdown是一种简单的标记语法,它可以使普通文本内容具有一定的格式。
1. 标题
标题是在文字前加#,一个#是第一级标题,两个#是第二级标题,以此类推,共支持六级标题,#和标题文字间要有空格。
# 一级标题
效果如下:
一级标题
一级标题另有一种写法,在文字下一行写至少三个=:
一级标题
===
效果如下:
一级标题
## 二级标题
效果如下:
二级标题
二级标题另有一种写法,在文字下一行写至少三个-:
二级标题
---
效果如下:
二级标题
### 三级标题
效果如下:
三级标题
#### 四级标题
效果如下:
四级标题
##### 五级标题
效果如下:
五级标题
###### 六级标题
效果如下:
六级标题
2. 文本
2.1. 普通文本
普通文本的写法和任何文本编辑器无异,直接书写即可。如输入以下内容:
奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会。
效果如下:
奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会。
2.2. 斜体、粗体、删除线
在文章中突出要点词语,句子可以用倾斜,加粗等方式展现,只要在文本的前后加上*号或者_号就可以了,前后各加一个*是倾斜,各加两个*是加粗。
例如,上面的文本想把最开始的奥林匹克运动会加粗,最后的体育盛会倾斜,就要在前者的前后各加两个*,后者的前后各加一个*:
**奥林匹克运动会**,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的*体育盛会*。
效果如下:
奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会。
下表列出各种词语的着重和要点写法:
语法 | 效果 |
---|---|
*斜体1* | 斜体1 |
_斜体2_ | 斜体2 |
**粗体1** | 粗体1 |
__粗体2__ | 粗体2 |
这是一个 ~~删除线~~ | 这是一个 |
***斜粗体1*** | 斜粗体1 |
___斜粗体2___ | 斜粗体2 |
***~~斜粗体删除线1~~*** | |
~~***斜粗体删除线2***~~ |
斜体、粗体、删除线可混合使用
2.3. 红字文本
红字文本是比倾斜,加粗更加醒目的突出样式,在要标红的文本前后各加一个`符号(反引号,通常在您键盘的Esc键下方,数字1的左边)。例如,上面的文本想把其中的每四年一届标红,就在前后各加一个`:
**奥林匹克运动会**,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,`每四年一届`,会期不超过16日,是世界上影响力最大的*体育盛会*。
效果如下:
奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会。
红字文本同样可以和前面介绍的倾斜,加粗等混合使用,方法是 `外面再套 *号。
2.4. 图片
可用下面的格式在文章中插入图片:

其中图片名可以省略。图片文件路径可以是绝对路径,如C:\Windows\Greenstone.bmp。如果图片和文章在同一个目录下,也可以只有文件名。例如:

因为这篇文章所在的目录中有田径.jpg,可以看到如下图片:
2.5. 链接
可用下面的格式在文章中插入链接:
[链接名](URL或者文件路径)
例如在文章中插入Google的链接:
[Google](https://www.google.com)
效果如下:
此时点击Google会跳转到Google的官网。
2.5.1. 链接本地文件
除了可以链接网址外,还可以链接本地文件,例如:
[Windows 目录中的绿石图片](C:\Windows\Greenstone.bmp)
效果如下:
Windows 目录中的绿石图片
要注意前面加惊叹号和不加惊叹号的区别,加了惊叹号会把它当图片处理,如果是本软件支持的图片格式,会在文章中显示它;不加惊叹号会把它当链接处理,点击它会打开文件位置。文件路径可以是绝对路径,也可以是文章的相对路径。
2.5.2. 链接其它文章
通过链接其它文章,可以实现在文章间的跳转。例如文章A中一个话题在文章B中有更详细的展开讨论,可以在文章A中使用一个跳转到文章B的链接,和前面的链接本地文件一样的格式,例如:
[关于本软件](intro:关于)
效果如下:
关于本软件
2.5.3. 段落锚点
通过在链接文章后面加上#段落名,可以实现跳转到文章的指定段落。段落名是此段落的标题,可以是一级标题,二级标题,直至六级标题。例如,本段落的段落名是段落锚点,四级标题。
如果要跳转到本文内的锚点,可以省略文章名,例如
[跳转到列表](#5.%20列表)
效果如下:
段落锚点可以是任意一级标题,如果文章中有两个同名标题,那么只能设置前一个为锚点,点击后只会跳转到前一个段落上。
3. 横线
只要在一行内打出三个或以上的*、-、_就可以在文章中画一条横线:
以下三种写法都是一样的效果:
一行三个*号:
***
一行三个-号:
---
一行三个_号:
___
效果如下:
4. 引用
引用名人名言,或者其他人在其它文章中的话语,一般将其放在一个引用段中。引用是在文字前加>号,>和引用的文字间要有空格。例如:
> 奥林匹克运动会发源于两千多年前的古希腊,因举办地在奥林匹亚而得名。古代奥林匹克运动会停办了1500年之后,法国人顾拜旦于19世纪末提出举办现代奥林匹克运动会的倡议。1894年成立奥委会,1896年举办了首届奥运会,1924年举办了首届冬奥会,1960年举办了首届残奥会,2010年举办了首届青奥会,2012年举办了首届青冬奥会。
效果如下:
奥林匹克运动会发源于两千多年前的古希腊,因举办地在奥林匹亚而得名。古代奥林匹克运动会停办了1500年之后,法国人顾拜旦于19世纪末提出举办现代奥林匹克运动会的倡议。1894年成立奥委会,1896年举办了首届奥运会,1924年举办了首届冬奥会,1960年举办了首届残奥会,2010年举办了首届青奥会,2012年举办了首届青冬奥会。
5. 列表
如果多行有并列关系,可以用列表的形式呈现,显得更加整洁。列表由多个行组成,每一行都有相同的格式要求。
5.1. 无序列表
无序列表是在每行行首加*号,*和文字间要有空格。例如:
* 田径:田径是体育运动中最古老的运动。
* 赛艇:运动员背向前进方向划水的一项划船运动。
* 自行车:起源于欧洲。1896年列为首届奥运会比赛。
效果如下:
- 田径:田径是体育运动中最古老的运动。
- 赛艇:运动员背向前进方向划水的一项划船运动。
- 自行车:起源于欧洲。1896年列为首届奥运会比赛。
5.2. 有序列表
有序列表是在每行行首加数字,数字和文字间要有空格。例如:
1. 田径:47枚金牌
2. 游泳:44枚金牌
3. 自行车:18枚金牌
效果如下:
- 田径:47枚金牌
- 游泳:44枚金牌
- 自行车:18枚金牌
5.3. 多级列表
如果列表中的某一项可以继续展开,还可以嵌入其它列表,也就是多级列表。在上面两种段首前加上三个空格就变成了第二级列表。有序列表中可以嵌入无序列表,无序列表中也可以嵌入有序列表。例如:
1. 田径:47枚金牌
2. 游泳:44枚金牌
1. 泳道游泳:34枚金牌
2. 跳水:8枚金牌
3. 花样游泳:2枚金牌
3. 自行车:18枚金牌
1. 山地:2枚金牌
2. 公路:4枚金牌
3. 场地:10枚金牌
4. BMX小轮车:2枚金牌
效果如下:
5.4. 列表中嵌入图片
和普通文本中一样,列表中也可以嵌入图片,例如:
1. :47枚
2. 游泳:44枚
1. :34枚
2. :8枚
3. :2枚
3. :18枚
1. 山地:2枚
2. 公路:4枚
3. 场地:10枚
4. BMX小轮车:2枚
效果如下:
- 田径:47枚金牌
- 游泳:44枚金牌
- 泳道游泳:34枚金牌
- 跳水:8枚金牌
- 花样游泳:2枚金牌
- 自行车:18枚金牌
- 山地:2枚金牌
- 公路:4枚金牌
- 场地:10枚金牌
- BMX小轮车:2枚金牌
5.5. 任务列表
任务列表和普通列表相比,每个列表项前面有一个任务状态标识,有选中和未选中两种状态,通常用来表示已做任务和未做任务。选中状态的写法是- [x],未选中状态的写法是- [ ],注意横线和方括号之间有空格,方括号和后面的文字之间也要有空格,例如:
- [x] 田径比赛已结束 - [x] 游泳比赛正在进行中 - [x] 泳道游泳已结束 - [ ] 跳水正在进行中 - [ ] 花样游泳未开始 - [ ] 自行车比赛未开始
效果如下:
6. 表格
markdown中并不直接支持很复杂的表格,通常就是m行*n列的普通表格,可以有表头,也就是(m数据行+1表头行)*n列。表格是通过表示竖线的|字符和表示横线的-字符“画”表格。比如下面的字符表格:
|届数|赛事名称|举办国家|主办城市|举办时间| |---|---|---|---|---| |第01届|1896年雅典奥运会|希腊|雅典|1896年04月06日-1896年04月15日| |第02届|1900年巴黎奥运会|法国|巴黎|1900年05月20日-1900年10月28日| |第03届|1904年圣路易斯奥运会|美国|圣路易斯|1904年07月01日-1904年11月23日| |第04届|1908年伦敦奥运会|英国|英国|1908年04月27日-1908年10月31日|
效果如下:
届数 赛事名称 举办国家 主办城市 举办时间 第01届 1896年雅典奥运会 希腊 雅典 1896年04月06日-1896年04月15日 第02届 1900年巴黎奥运会 法国 巴黎 1900年05月20日-1900年10月28日 第03届 1904年圣路易斯奥运会 美国 圣路易斯 1904年07月01日-1904年11月23日 第04届 1908年伦敦奥运会 英国 英国 1908年04月27日-1908年10月31日 6.1. 表格中嵌入图片
和普通文本中一样,表格可以在表头和表数据的文本中嵌入图片,例如:
| 排行 | 国家 |  |  |  | 总数 | |----|------|------|-----|-----|------| | 1 |  | 1022 | 794 | 704 | 2520 | | 2 |  | 591 | 500 | 490 | 1581 | | 3 |  | 428 | 442 | 476 | 1346 | | 4 |  | 263 | 295 | 289 | 847 | | 5 |  | 227 | 162 | 155 | 544 |
效果如下:
排行 国家 总数 1 1022 794 704 2520 2 591 500 490 1581 3 428 442 476 1346 4 263 295 289 847 5 227 162 155 544 6.2. 表格对齐
表格内的对齐方式在第二行,也就是在由纯|字符和-字符组成的表头/表数据分隔行内控制,如果一个单元格是以:开头并且以:结尾,那么此列是居中,仅以:开头是左对齐,仅以:结尾是右对齐,例如下面的表中,注意第二行:
| 左对齐 | 居中 | 右对齐 | | :------------ |:---------------:| -----:| | col 3 is | some wordy text | $1600 | | col 2 is | centered | $12 | | zebra stripes | are neat | $1 |
效果如下:
左对齐 居中 右对齐 col 3 is some wordy text $1600 col 2 is centered $12 zebra stripes are neat $1 7. 代码
程序员写技术文章通常要在里面插入一段一段的代码,用markdown插入代码非常方便,还可以给代码设置语法颜色。代码分为行内代码和块代码。
7.1. 行内代码
行内代码书写格式是用两个反引号(通常在您键盘的Esc键下方,数字1的左边),如:
C语言的字符串格式化函数是:`printf`
效果如下:
C语言的字符串格式化函数是:printf
行内代码通常可以用来写函数名,命令,文件名等等。
行内代码和前面介绍的红字文本是相同的写法,只是使用场景不同。
7.2. 块代码
块代码由多行组成,首行是三个反引号,尾行也是三个反引号,中间是代码块。
``` int main(int argc, char *argv[]) { printf("Hello, world!\n"); } ```
效果如下:
int main(int argc, char *argv[]) { printf("Hello, world!\n"); }
7.3. 代码语法高亮
行内代码不能使用语法名,而块代码可以在首行三个反引号后面加上语法名,指定代码块使用的语法。
如下面的代码没有设置语法名,也无法显示语法信息:
``` print "Hello, world!\n"; ```
效果如下:
print "Hello, world!\n";
设置了python语法名后,会按照python语法显示语法信息:
```python print "Hello, world!\n"; ```
效果如下:
print "Hello, world!\n";
代码段内不能使用前面介绍的各种文本格式,如倾斜,加粗等等,也不能使用图片和链接,所有的文本都是直接文本