markdown语法详解(上)

本文将以最流行的GFM(GitHub Flavored Markdown)为例,介绍markdown中各种文本格式,图片,链接的写法。

文本的写法

普通段落文本

普通段落和用word书写无异,直接书写即可。如:

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

在文章中一个段落中可以有多个句子,句子用句号,问号,惊叹号等结束,而一个段落的结束用回车。

斜体、粗体、删除线

在文章中突出要点词语,句子可以用倾斜,加粗等方式展现,word中要选中文本,然后赋予样式,而markdown只要在文本的前后加上*号就可以了。

前后各加一个*号,文字将倾斜:

*斜体*的最终效果是斜体

前后各加两个*号,文字将加粗:

**粗体**的最终效果是粗体

前后各加两个~号,文字中将出现删除线,这是一种反向强调,表示“不应该”,“不正确”等等意思:

~~删除~~的最终效果是删除

下表列出所有特殊符号对应的效果

语法 效果
*斜体1* 斜体1
_斜体2_ 斜体2
**粗体1** 粗体1
__粗体2__ 粗体2
~~删除线~~ 删除线
***斜粗体1*** 斜粗体1
___斜粗体2___ 斜粗体2
***~~斜粗体删除线1~~*** 斜粗体删除线1
~~***斜粗体删除线2***~~ 斜粗体删除线2
斜体、粗体、删除线可混合使用。
上述的*_~这些符号都是英文符号,在中文环境下使用较少,所以用来标明特殊格式不会有问题,如果要使用上述符号,请在前面一个\,比如\*最终效果是*

用这种前后加符号的方式来标注特殊格式好处是更加快捷,修改方便,而且是可读文本,在markdown编辑器中这些符号会转换为格式,而普通的文本编辑器看到的是符号,不会影响阅读内容。

红字文本

红字文本是比倾斜,加粗更加醒目的突出样式,word中通常是选中文本,然后点击字体颜色。markdown中则是在要标红的文本前后各加一个`符号,方法和前面介绍的倾斜,加粗一样:

`红字`的最终效果是红字
红字也可以和斜体,粗体,删除线混合使用。如*`倾斜红字`*的最终效果是倾斜红字
markdown设置不同的字体颜色只有`一个符号,默认就是红色,但是可以用css设置为其它颜色,如蓝色,绿色,但只有一种异色效果。

标题

markdown中在一个普通段落前加#,将其设置为标题。一个#就是一级标题,两个#就是二级标题,一共可以有六级标题。

语法 效果
# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

#### 四级标题

四级标题

##### 五级标题
五级标题
###### 六级标题
六级标题

作为最常见的一级标题和二级标题,还可以用另一种写法,一级标题下面加上三个(或更多)连续的=号,二级标题下面加上三个(或更多)连续的-号:

语法 效果
一级标题
===

一级标题

二级标题
---

二级标题

注意和前面介绍的文本格式不同,标题不需要在首尾各加一个特殊符号,只要在首部加#就可以了,而且必须是在行首。
标题和普通文本一样,里面的文本也可以用红字,斜体,粗体,删除线。但是一般标题的样式都是粗体,再用粗体肉眼分辨不出来。

图片的写法

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

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

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

![田径](田径.jpg)
像迷你档这样的markdown编辑器可以直接把图片文件拖到文章中,也可以粘贴图片文件,图片数据。如果粘贴的是图片数据,会自动在编辑器的管理目录中创建一个图片文件保存数据,并用上面的图片格式插入到文章中。

链接的写法

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

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

例如[Google](https://www.google.com),此时点击Google会跳转到Google的官网。

和前面的图片写法比较,可以看出什么不同?答案是链接没有前面的惊叹号。
链接也可以和红字,斜体,粗体,删除线等混合使用,也可以用在标题中。

链接本地文件

除了可以链接网址外,还可以链接本地文件,例如[绿石](C:\Windows\Greenstone.bmp),要注意前面加惊叹号和不加惊叹号的区别,加了惊叹号会把它当图片处理,如果是本软件支持的图片格式,会在文章中显示它;不加惊叹号会把它当链接处理,点击它会打开文件位置。文件路径可以是绝对路径,也可以是文章的相对路径。

链接其它文章

通过链接其它文章,可以实现在文章间的跳转。例如文章A中一个话题在文章B中有更详细的展开讨论,可以在文章A中使用一个跳转到文章B的链接,和前面的链接本地文件一样的格式,例如:[什么是markdown](what_is_markdown.html)

段落锚点

通过在链接文章后面加上#段落名,可以实现跳转到文章的指定段落。段落名是此段落的标题,可以是一级标题,二级标题,直至六级标题。

如果要跳转到本文内的锚点,可以省略文章名,例如[跳转到本文关于标题的介绍](#标题)

段落锚点可以是任意一级标题,如果文章中有两个同名标题,那么只能设置前一个为锚点,点击后只会跳转到前一个段落上。

更多

前面介绍的是markdown中关于文本,图片,链接的写法,下一篇将介绍列表,表格,代码段,引用段的写法。

回到首页