)# 标题语法
创建标题在文字前添加 #,数量表示标题的级别。
也可在文本下方添加任意数量的 == 或者 -- 可标识一级标题和二级标题,无需使用 #。
段落语法
使用空白行可将文本进行分隔,不要使用空格或制表符缩进段落。
换行语法
在行末尾添加两个及以上的空格 + 回车键即可换行。
强调语法
粗体
在文本前后各添加两个星号 **(推荐) 或 下划线 __ 可对其间的文本进行加粗。
斜体
在文本前后各添加一个星号 *(推荐) 或 下划线 _ 可将其间的文本转换为斜体。
注:使用三个星号或下划线可同时有加粗和斜体的效果
引用语法
使用 > 符号来创建一个块引用;
> 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
- first
- second
- 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]
链接的第二部分格式
引用类型链接的第二部分使用以下属性设置格式:
- 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如
[label]:)。 - 链接的URL,可以选择将其括在尖括号中。
- 链接的可选标题,可以将其括在双引号,单引号或括号中。
[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")]()
转义字符语法
特殊字符自动转义
< 写为 < <
& 写为 & &
表格语法
使用三个或多个连字符(---)创建每列的标题,并使用管道(|)分隔每列。在标题行中的连字符的左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心。表格内同样可以设置文本格式。管道字符可使用|表示( | )
| *Syntax* | **Description** | ***Test Text***|
| :--- | :----: | ---: |
| Header | Title | Here's this |
| Paragraph | Text | And more |
| Syntax | Description | Test Text |
|---|---|---|
| Header | Title | Here's this |
| Paragraph | Text | And 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 等来源复制表情符号并将其粘贴到文档中
- 使用符号简码 : 以冒号开头和结尾,并包含表情符号的名称
更多可见表情符号简码表