# Markdown语法
参考文档:Markdown中文指南 (opens new window)
# 标题
要创建标题,请在单词或短语前面添加井号 (#) 。一个#代表一级标题。
- # Heading level 1 一级标题
- ## Heading level 2 二级标题
- ### Heading level 3 三级标题
- #### Heading level 4 四级标题
- ##### Heading level 5 五级标题
# 段落
中间空一个空行就可以形成两个段落。
# 换行
在一行的末尾添加两个或多个空格,然后按回车键(return),即可创建一个换行(line break)或新行 (<br>
)。
# 强调
# 粗体
在单词或短语的前后各添加两个星号或下划线。
Markdown | 渲染效果 |
---|---|
I just love bold text. | I just love bold text. |
I just love bold text. | I just love bold text. |
Loveisbold | Loveisbold |
# 斜体
在单词或短语前后添加一个星号或下划线
Markdown | 渲染效果 |
---|---|
Italicized text is the cat's meow. | Italicized text is the cat’s meow. |
Italicized text is the cat's meow. | Italicized text is the cat’s meow. |
Acatmeow | Acatmeow |
# 块引用
在文字前添加一个 >
符号。
> 已经会了 HTML、CSS、JavaScript?即刻阅读指南开始构建应用!
渲染效果如下所示:
已经会了 HTML、CSS、JavaScript?即刻阅读指南开始构建应用!
# 多个段落的块引用
块引用可以包含多个段落。为段落之间的空白行各添加一个 >
符号。
> 数据类型
>
> 作为一个代码托管平台,其核心思想就是版本控制和团队协作。
渲染效果如下:
数据类型 作为一个代码托管平台,其核心思想就是版本控制和团队协作
# 嵌套代码块
> 数据类型
>
>> 作为一个代码托管平台,其核心思想就是版本控制和团队协作。
# 带有其它元素的块引用
块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,你需要进行实验以查看哪些元素有效。
> #### 这个结果看起来很棒!
>
> * 列表数据1.
> * 列表数据1.
>
> *斜体* xxxxxx **加粗**.
# 列表
# 有序列表
在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
1.列表一
2.列表二
3.列表三
# 无序列表
在每个列表项前面添加破折号 (-
)、星号 (*
) 或加号 (+
) 。缩进一个或多个列表项可创建嵌套列表。
# 嵌套列表
可以将无序列表嵌套在有序列表中,反之亦然。
1. First item
2. Second item
3. Third item
- Indented item
- Indented item
4. Fourth item
# 代码
代码短语或者表达式可以放在 var a = 1
。
代码块放在 ```
当中 可以在 后面添加各种语言的标识来显示高亮效果。
\```js
\var a = 1
\```
# 分隔线
要创建分隔线,请在单独一行上使用三个或多个星号 (***
)、破折号 (---
) 或下划线 (___
) ,并且不能包含其他内容。
***
---
_________________
# 链接
[百度](https://baidu.com).
要将 URL 或电子邮件地址快速转换为链接,请将其括在尖括号中。
<https://www.markdownguide.org>
<fake@example.com>
渲染效果如下: https://www.markdownguide.org (opens new window)
# 格式化链接
如需 强调(emphasize) (opens new window) 某个链接, 请在方括号前及圆括号后添加星号。要将链接表示为 代码(code) (opens new window) ,请在方括号内添加反引号。
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 (opens new window).
This is the Markdown Guide (opens new window).
See the section on code
.
# 图片
![名称](地址) 地址可以是本地地址,也可以是base64位地址。
![图片](/assets/images/logo.png")
# 转义字符
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 (\
)
\* 如果没有开头的反斜杠字符的话,这一行将显示为无序列表。
以下列出的字符都可以通过使用反斜杠字符从而达到转义目的。
字符 | 名称 |
---|---|
|反斜杠(backslash) | |
` | backtick (另请参见 在代码中转义反引号 (opens new window)) |
* | 星号(asterisk) |
_ | 下划线(underscore) |
{ } | 花括号(curly braces) |
[ ] | 方括号(brackets) |
< > | angle brackets |
( ) | 圆括号或括号(parentheses) |
# | 井号(pound sign) |
+ | 加号(plus sign) |
- | 减号(minus sign) (也叫连字符 hyphen) |
. | 句点(dot) |
! | 感叹号(exclamation mark) |
| | 管道符(pipe) (另请参见 在表格中转义管道符 (opens new window)) |