标题语法
不同的'#'数量用来完成不同标题。
为了兼容性,请用一个空格在'#'和标题之间进行分隔。
在文本下方添加任意数量的 == 号来标识一级标题,或者 -- 号来标识二级标题。
段落语法
要创建段落,请使用空白行将一行或多行文本进行分隔。
不要用空格(spaces)或制表符( tabs)缩进段落。
换行语法
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行。
为了兼容性,请在行尾添加“结尾空格”或 HTML 的<br>
标签来实现换行。
至少有两种轻量级标记语言支持键入回车键(return)实现换行。
强调语法
粗体(Bold):在单词或短语的前后各添加两个星号(asterisks)(或下划线underscores用于单词或短语的中间部分)。
斜体(Italic):在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。
粗体(Bold)和斜体(Italic):在单词或短语的前后各添加三个星号(或下划线用于单词或短语的中间部分),中间不要带空格。
引用语法
一个段落的块引用:在段落前添加一个 > 符号。
多个段落的块引用:为段落之间的空白行添加一个 > 符号。
嵌套块引用:在要嵌套的段落前添加一个 >> 符号。
带有其它元素的块引用:块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,需要进行实验以查看哪些元素有效。
列表语法
有序列表:在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
无序列表:在每个列表项前面添加破折号 (-
)、星号 (*
) 或加号 (+
) 。缩进一个或多个列表项可创建嵌套列表。
在列表中嵌套其他元素:要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格
或一个制表符
。
引用块:采用四个空格或一个制表符缩进后,加引用符号>
。
代码块:采用四个空格
或一个制表符
缩进。当它们被放在列表中时,请将它们缩进八个空格
或两个制表符
。
图片:采用四个空格或一个制表符缩进后,语法为:
![Tux, the Linux mascot](/assets/images/tux.png)
代码语法
代码:要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。
代码中包含反引号:如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
围栏代码块:在代码块之前和之后的行上使用三个反引号((```)或三个波浪号(~~~)。
添加语法突出显示:在受防护的代码块之前的反引号旁边指定一种语言。
"hello world"
分隔线语法
在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。
为了兼容性,请在分隔线的前后均添加空白行。
链接语法
链接:链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
超链接:
[超链接显示名](超链接地址 "超链接title")
给链接增加 Title:链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。
(https://markdown.com.cn "最好的markdown教程")。
网址和Email地址:使用尖括号可以很方便地把URL或者email地址变成可点击的链接。<https://markdown.com.cn> <fake@example.com>
带格式化的链接:在链接语法前后增加星号。
将链接表示为代码:在方括号中添加反引号。
引用类型链接:参考样式链接分为两部分:与文本保持内联的部分以及存储在文件中其他位置的部分,以使文本易于阅读。
-
引用类型的链接的第一部分:使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。
尽管不是必需的,可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。 -
引用类型链接的第二部分:放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如[label]:)。
链接的URL,可以选择将其括在尖括号中。链接的可选标题,可以将其括在双引号,单引号或括号中。
可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后,有些人则将它们放在文档的末尾(例如尾注或脚注)。
图片语法
添加图像:用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片:[图片上传失败...(image-e4319b-1627008305585)]
。
对应的HTML代码:<img src="图片链接" alt="图片alt" title="图片title">
链接图片:将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。
[[图片上传失败...(image-d5d132-1627008305585)]](https://markdown.com.cn)
转义字符语法
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 () 。
可做转义的字符:
\ ` * _ { } [ ] ( ) # + - . ! |
特殊字符自动转义:
在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你只是想要使用这些符号,你必须要使用实体的形式,像是 < 和 &。
& 符号其实很容易让写作网页文件的人感到困扰,如果你要打「AT&T」 ,你必须要写成「AT&T」 ,还得转换网址内的 & 符号,如果你要链接到:http://images.google.com/images?num=30&q=larry+bird
,必须要把网址转成:http://images.google.com/images?num=30&q=larry+bird
,才能放到链接标签的 href 属性里。
Markdown 允许你直接使用这些符号,它帮你自动转义字符。如果你使用 & 符号的作为 HTML 实体的一部分,那么它不会被转换,而在其它情况下,它则会被转换成 &。
需要特别注意的是,在 Markdown 的块级元素和内联元素中, < 和 & 两个符号都会被自动转换成 HTML 实体,这项特性让你可以很容易地用 Markdown 写 HTML。(在 HTML 语法中,你要手动把所有的 < 和 & 都转换为 HTML 实体。)