Markdown是一种轻量级的标记语言,以排版语法简洁著称,其目的是让人们更多地关注内容本身而非排版。本文是对其语法的一个简明总结,其内容足以应付多数场合。若需要更为高级的用法,详细内容可参考Markdown的官方文档。
1.标题语法
在标题的具体内容前添加井号 (#) 。# 的数量代表了标题的级别。级别越小,则标题字体越大。例如,本文此处的标题即为添加两个# 而得的二级标题。
2.换行语法
在一行的末尾添加两个或多个空格,然后回车,即可实现换行。另外,在行尾添加一个换行符(<br>)也可以起到同样的效果。
3.段落语法
在Markdown中,请使用空白行将一行或多行文本进行分隔,以表示段落。注意:不要像在书写word文档时,用空格(spaces)或制表符( tabs)缩进段落。
在每个段落块前添加破折号 (-)、星号 (*) 或加号 (+)以实现无序列表。例如:
- 无序列表
- 有序列表
在每个列表项前添加数字并紧跟一个英文句点,以创建有序列表。例如:
- 有序列表1
- 有序列表2
4.强调语法
粗体
要加粗文本,请在单词或短语的前后各添加两个星号(*)或下划线(_)。例如,写作:**Markdown**,效果即为:Markdown。
斜体
要用斜体显示文本,请在单词或短语前后添加一个星号(*)或下划线(_)。例如,写作:*Markdown*,效果即为:Markdown。
5.代码语法
单行
要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。例如,写作:`Hello world!`,效果即为:Hello world!。
如果要表示为代码的单词或短语中包含一个或n个反引号,则可以通过将单词或短语包裹在两个或n+1个反引号中,实现上述效果。即需要用更多的反引号(`)来包裹内容中的反引号,以实现上述效果。
例如,写作:`` `这是代码`Hello world!` ``,效果即为:`这是代码`Hello world!`。
而写作:``` `` `这是代码`Hello world!` `` ```,效果即为:`` `这是代码`Hello world!` ``。
代码块(详细语法参照官方文档)
要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。例如,写作:
<html>
<head>
</head>
</html>
实际效果则为:
<html>
<head>
</head>
</html>
6.引用语法
创建块引用,语法为在段落前添加一个 > 符号。例如,写作:
> Whether you like it or not, the ones that go forward dont go backwards.
效果为:
Whether you like it or not, the ones that go forward dont go backwards.
要注意,结束一段引用意味着结束一个段落。而段落采用空白行进行分割。
块引用也可以包含多个段落。为段落之间的空白行添加一个 > 符号。例如,写作:
> Whether you like it or not, the ones that go forward don’t go backwards.
>
> 不管你是否喜欢,该往前的不会后退.
效果为:
Whether you like it or not, the ones that go forward don’t go backwards.
不管你是否喜欢,该往前的不会后退.
7.分割线
要创建分隔线,请在单独一行中,使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,要注意该行不能包含其他内容。例如,写作:***,效果即为:
8.转义字符
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 。例如,写作:*Markdown*,效果即为:Markdown。使用转义字符后,写作\*Markdown*,效果即为*Markdown*
9.链接
在Markdown中添加链接,其语法结构为:[超链接显示名](超链接地址)。
例如,写作:[Markdown语法](https://markdown.com.cn)。其效果为:Markdown语法。
10.图片
添加图片
在Markdown中,添加图片的语法为:。例如,写作:
',效果即为:
带链接的图片
若需要给图片增加链接,则要将图像的括在方括号中,然后将链接添加在圆括号中。语法即为:[](超链接地址)。