MarkDown常用语法

610 阅读6分钟

)# 标题语法

创建标题在文字前添加 #,数量表示标题的级别。

image.png

也可在文本下方添加任意数量的 == 或者 -- 可标识一级标题和二级标题,无需使用 #

image.png

段落语法

使用空白行可将文本进行分隔,不要使用空格或制表符缩进段落。

image.png

换行语法

在行末尾添加两个及以上的空格 + 回车键即可换行。

image.png

强调语法

粗体

在文本前后各添加两个星号 **推荐) 或 下划线 __ 可对其间的文本进行加粗。

斜体

在文本前后各添加一个星号 *推荐) 或 下划线 _ 可将其间的文本转换为斜体。

注:使用三个星号或下划线可同时有加粗和斜体的效果

引用语法

使用 > 符号来创建一个块引用;
> hello world

hello world

多个段落的块引用中,段落分隔需要在空行前也加上 >
> hello world
>
> this is a rookie

hello world

this is a rookie

块引用支持嵌套,使用 >> 可达到嵌套的效果;
> hello world
>
>> hello markdown

hello world

hello markdown

块引用中支持使用其他的语法

> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
> *Everything* is going according to **plan**.

The quarterly results look great!

  • Revenue was off the chart.
  • Profits were higher than ever.

Everything is going according to plan.

列表语法

有序列表

在每一个列表项前添加任意数字并紧跟一个英文句点 . 即可创建有序列表,列表要以数字 "1"为起始。
1. first
3. second
8. third

  1. first
  2. second
  3. third

无序列表

在每一个列表项前添加- * + 即可创建无序列表。 - first
- second

  • first
  • second

注:可使用缩进创建嵌套列表项

嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符,如果是代码块,置于列表中需要缩进八个空格或两个制表符。

代码语法

  • 使用反引号 ` 包裹代码。
  • 如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
  • 创建代码块则需要将代码块每一行缩进至少四个空格或一个制表符。

分隔线语法

要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。


链接语法

链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
超链接Markdown语法代码:[超链接显示名](超链接地址 "超链接title")

本文内容均来自于[Markdown官方教程](https://markdown.com.cn/)

本文内容均来自于Markdown官方教程

链接的title

链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。

本文内容均来自于[Markdown官方教程](https://markdown.com.cn "最好的markdown教程")

本文内容均来自于Markdown官方教程

网址和Email地址

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。

带格式化的链接

强调 链接, 在链接语法前后增加星号。 要将链接表示为代码,请在方括号中添加反引号。
I love supporting the **[EFF](https://eff.org)**. This is the *[Markdown Guide](https://www.markdownguide.org)*. See the section on [`code`](#code).
I love supporting the EFF.
This is the Markdown Guide.
See the section on code.

引用类型链接

参考样式链接分为两部分:与文本保持内联的部分以及存储在文件中其他位置的部分,以使文本易于阅读。

链接的第一部分格式

使用两组括号进行格式设置。

第一组方括号包围应显示为链接的文本。
第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。

[hobbit-hole] [1]
[hobbit-hole] [1]

链接的第二部分格式

引用类型链接的第二部分使用以下属性设置格式:

  1. 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如[label]:)。
  2. 链接的URL,可以选择将其括在尖括号中。
  3. 链接的可选标题,可以将其括在双引号,单引号或括号中。

[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"
[1]: en.wikipedia.org/wiki/Hobbit… "Hobbit lifestyles"

图片语法

要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。

插入图片Markdown语法代码: ![图片转存失败,建议将图片保存下来直接上传 图片alt(图片链接 "图片title")]()
![图片转存失败,建议将图片保存下来直接上传 沙漠中的岩石图片(https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/e2af9ad770aa474db54c1f60025df2d3~tplv-k3u1fbpfcp-zoom-1.image "Shiprock")]() 沙漠中的岩石图片

转义字符语法

image.png

特殊字符自动转义

< 写为 &lt; <

& 写为 &amp; &

表格语法

使用三个或多个连字符(---)创建每列的标题,并使用管道(|)分隔每列。在标题行中的连字符的左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心。表格内同样可以设置文本格式。管道字符可使用&#124;表示( | )

| *Syntax*    | **Description** | ***Test Text***|
| :---        |    :----:       |           ---: |
| Header      | Title           | Here's this    |
| Paragraph   | Text            | And more       |
SyntaxDescriptionTest Text
HeaderTitleHere's this
ParagraphTextAnd more

围栏代码块

在代码块之前和之后的行上使用三个反引号(```)或三个波浪号(~~~),为代码块指定语言可支持语法突出显示。

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

定义的列表

在第一行上键入术语。在下一行,键入一个冒号,后跟一个空格和定义。

First Term
: This is the definition of the first term.

Second Term
: This is one definition of the second term.
: This is another definition of the second term.

First Term : This is the definition of the first term.

Second Term : This is one definition of the second term. : This is another definition of the second term.

删除线

在单词前后使用两个波浪号~~
~~世界是平坦的~~
世界是平坦的

使用emoji

  • 复制粘贴 : 从Emojipedia 等来源复制表情符号并将其粘贴到文档中
  • 使用符号简码 : 以冒号开头和结尾,并包含表情符号的名称

image.png

image.png

更多可见表情符号简码表