markdown 写法

markdown是一种简单的标记语法,它可以使普通文本内容具有一定的格式。

1. 标题

标题是在文字前加#,一个#是第一级标题,两个#是第二级标题,以此类推,共支持六级标题,#和标题文字间要有空格。

# 一级标题

效果如下:

一级标题

一级标题另有一种写法,在文字下一行写至少三个=

一级标题
===

效果如下:

一级标题

## 二级标题

效果如下:

二级标题

二级标题另有一种写法,在文字下一行写至少三个-

二级标题
---

效果如下:

二级标题

### 三级标题

效果如下:

三级标题

#### 四级标题

效果如下:

四级标题

##### 五级标题

效果如下:

五级标题

###### 六级标题

效果如下:

六级标题

2. 文本

2.1. 普通文本

普通文本的写法和任何文本编辑器无异,直接书写即可。如输入以下内容:

奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会。

效果如下:

奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会。

2.2. 斜体、粗体、删除线

在文章中突出要点词语,句子可以用倾斜,加粗等方式展现,只要在文本的前后加上*号或者_号就可以了,前后各加一个*是倾斜,各加两个*是加粗。

例如,上面的文本想把最开始的奥林匹克运动会加粗,最后的体育盛会倾斜,就要在前者的前后各加两个*,后者的前后各加一个*

**奥林匹克运动会**,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的*体育盛会*。

效果如下:

奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会

下表列出各种词语的着重和要点写法:

语法效果
*斜体1*斜体1
_斜体2_斜体2
**粗体1**粗体1
__粗体2__粗体2
这是一个 ~~删除线~~这是一个 删除线
***斜粗体1***斜粗体1
___斜粗体2___斜粗体2
***~~斜粗体删除线1~~***斜粗体删除线1
~~***斜粗体删除线2***~~斜粗体删除线2
斜体、粗体、删除线可混合使用

2.3. 红字文本

红字文本是比倾斜,加粗更加醒目的突出样式,在要标红的文本前后各加一个`符号(反引号,通常在您键盘的Esc键下方,数字1的左边)。例如,上面的文本想把其中的每四年一届标红,就在前后各加一个`

**奥林匹克运动会**,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,`每四年一届`,会期不超过16日,是世界上影响力最大的*体育盛会*。

效果如下:

奥林匹克运动会,是国际奥林匹克委员会主办的世界规模最大的综合性运动会,每四年一届,会期不超过16日,是世界上影响力最大的体育盛会

红字文本同样可以和前面介绍的倾斜,加粗等混合使用,方法是 `外面再套 *号。

2.4. 图片

可用下面的格式在文章中插入图片:

![图片名](图片文件路径)

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

![田径的奥运符号](田径.jpg)

因为这篇文章所在的目录中有田径.jpg,可以看到如下图片:

2.5. 链接

可用下面的格式在文章中插入链接:

[链接名](URL或者文件路径)

例如在文章中插入Google的链接:

[Google](https://www.google.com)

效果如下:

Google

此时点击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枚金牌

效果如下:

  1. 田径:47枚金牌
  2. 游泳:44枚金牌
  3. 自行车: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. ![田径](田径.jpg):47枚![金牌](gold.png)
2. 游泳:44枚![金牌](gold.png)
   1. ![泳道游泳](游泳.jpg):34枚![金牌](gold.png)
   2. ![跳水](跳水.jpg):8枚![金牌](gold.png)
   3. ![花样游泳](花样游泳.jpg):2枚![金牌](gold.png)
3. ![自行车](自行车.jpg):18枚![金牌](gold.png)
   1. 山地:2枚![金牌](gold.png)
   2. 公路:4枚![金牌](gold.png)
   3. 场地:10枚![金牌](gold.png)
   4. BMX小轮车:2枚![金牌](gold.png)

效果如下:

  1. 田径:47枚金牌
  2. 游泳:44枚金牌
    1. 泳道游泳:34枚金牌
    2. 跳水:8枚金牌
    3. 花样游泳:2枚金牌
  3. 自行车:18枚金牌
    1. 山地:2枚金牌
    2. 公路:4枚金牌
    3. 场地:10枚金牌
    4. 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. 表格中嵌入图片

    和普通文本中一样,表格可以在表头和表数据的文本中嵌入图片,例如:

    | 排行 | 国家   | ![金牌](gold.png)   | ![银牌](silver.png)  | ![铜牌](bronze.png)  | 总数   |
    |----|------|------|-----|-----|------|
    | 1  | ![美国](美国.png)   | 1022 | 794 | 704 | 2520 |
    | 2  | ![俄罗斯](俄罗斯.png)  | 591  | 500 | 490 | 1581 |
    | 3  | ![德国](德国.png)   | 428  | 442 | 476 | 1346 |
    | 4  | ![英国](英国.png)   | 263  | 295 | 289 | 847  |
    | 5  | ![中国](中国.png)   | 227  | 162 | 155 | 544  |

    效果如下:

    排行国家总数
    110227947042520
    25915004901581
    34284424761346
    4263295289847
    5227162155544

    6.2. 表格对齐

    表格内的对齐方式在第二行,也就是在由纯|字符和-字符组成的表头/表数据分隔行内控制,如果一个单元格是以:开头并且以:结尾,那么此列是居中,仅以:开头是左对齐,仅以:结尾是右对齐,例如下面的表中,注意第二行:

    | 左对齐 | 居中  | 右对齐 |
    | :------------ |:---------------:| -----:|
    | col 3 is      | some wordy text | $1600 |
    | col 2 is      | centered        |   $12 |
    | zebra stripes | are neat        |    $1 |

    效果如下:

    左对齐居中右对齐
    col 3 issome wordy text$1600
    col 2 iscentered$12
    zebra stripesare 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";
    代码段内不能使用前面介绍的各种文本格式,如倾斜,加粗等等,也不能使用图片和链接,所有的文本都是直接文本
  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值