Markdown简明语法

244 阅读4分钟

Markdown是一种轻量级的标记语言,以排版语法简洁著称,其目的是让人们更多地关注内容本身而非排版。本文是对其语法的一个简明总结,其内容足以应付多数场合。若需要更为高级的用法,详细内容可参考Markdown的官方文档

1.标题语法

在标题的具体内容前添加井号 (#) 。# 的数量代表了标题的级别。级别越小,则标题字体越大。例如,本文此处的标题即为添加两个# 而得的二级标题。

2.换行语法

在一行的末尾添加两个或多个空格,然后回车,即可实现换行。另外,在行尾添加一个换行符(<br>)也可以起到同样的效果。

3.段落语法

在Markdown中,请使用空白行将一行或多行文本进行分隔,以表示段落。注意:不要像在书写word文档时,用空格(spaces)或制表符( tabs)缩进段落。

在每个段落块前添加破折号 (-)、星号 (*) 或加号 (+)以实现无序列表。例如:

  • 无序列表
  • 有序列表

在每个列表项前添加数字并紧跟一个英文句点,以创建有序列表。例如:

  1. 有序列表1
  2. 有序列表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中,添加图片的语法为:![图片alt](图片链接 "图片title")。例如,写作:
![这是图片](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/7fc6975f6c9d4a4388b114aa600c29c5~tplv-k3u1fbpfcp-zoom-1.image)',效果即为:
这是图片

带链接的图片

若需要给图片增加链接,则要将图像的括在方括号中,然后将链接添加在圆括号中。语法即为:[![图片alt](图片链接 "图片title")](超链接地址)