Markdown 基础语法
Markdown 是一种简单、易用的标记语言,它几乎可以格式化任何文本。
标题
使用标题符号 #
可以创建 1~6 级标题。 例如:
# 标题等级 1
...
###### 标题等级 6
注意: 标题符号 #
与标题文本之间有一个空格。
也可以使用 =
和 -
创建 1、2 级标题。 例如:
标题等级 1
===
标题等级 2
---
换行
在行尾使用两个空格进行换行。 例如:
文本行 1,行尾使用了两个空格。
文本行 2...
段落
使用空行可以形成段落。 例如:
段落 1,下面是空行。
段落 2,上面是空行。
分割线
在单独一行上连续使用三个 *
、-
或者 _
符号都可以创建分割线。 例如:
*** 分割线 1
--- 分割线 2
___ 分割线 3
斜体
要显示斜体文字,只需在文本前、后各输入一个 *
或者 _
符号。 例如:
*斜体文字*
_斜体文字_
注意: 符号 *
或者符号 _
与斜体文本之间没有空格。
粗体
要显示粗体文本,只需在文本前、后各输入两个 *
或者 _
符号。 例如:
**粗体文本**
__粗体文本__
注意: 符号 *
或者符号 _
与粗体文本之间没有空格。
粗斜体
要显示粗斜体,只需在文本前、后各输入三个 *
或者 _
符号。 例如:
***粗斜体文本***
___粗斜体文本___
注意: 符号 *
或者符号 _
与粗斜体文本之间没有空格。
块引用
使用符号 >
可以创建块引用(Blockquote)。 例如:
> 块引用 1
> 块引用 2
块引用可以嵌套,也可以包含其它 Markdown 元素,例如加粗效果等,具体可以添加的元素因解析器的差异而有所不同,请留意其说明。
注意: 块引用符号 >
与文本之间有一个空格。
有序列表
使用 数字
+ .
可以创建有序列表。 例如:
1. 有序列表 1
2. 有序列表 2
3. 有序列表 3
注意: 有序列表必须以数字开头。
另外,有序列表可以通过 Tab
键来增加层级关系,通过 Shift
+ Tab
组合键来减少层级关系。
无序列表
使用 *
、 -
、 +
符号中的任何一个都可以创建无序列表。 例如:
* 无序列表 1
+ 无序列表 2
- 无序列表 3
注意: 无序列表可以通过 Tab
键来增加层级关系,通过 Shift
+ Tab
组合键来减少层级关系。
代码
使用一对反引号 `
包含代码可以凸显代码文本。 例如:
这段文本中包含 `markdown` 元素。
注意: 反引号可以嵌套使用。
代码块
使用四个空格或者 Tab
键缩进文本可以创建代码块。 例如:
<html>
<head>
</head>
</html>
注意: 另一种创建代码块的方式,请参考扩展语法中的相关介绍。
网址和邮件地址
将网址或邮件地址放入一对 <>
中,即可快速转换为链接。 例如:
<http://markdown.com/>
<[email protected]>
链接
把文本放在 []
中,URL 放在 ()
中,即可创建文本链接。 例如:
推荐使用[百度](https://www.baidu.com)查找资料。
还可以在 URL 后面输入信息,为链接文本添加工具提示。 例如:
推荐使用[百度](https://www.baidu.com "搜索引擎")查找资料。
注意: 方括号和圆括号之间没有空格。
引用链接
通过引用自定义标签处提供的 URL 创建链接。 例如:
推荐使用[百度][baidu]查找资料。
...
[baidu]: https://www.baidu.com "搜索引擎"
注意: 自定义的标签可以放在任何位置,推荐放在文档最后,方便统一管理。
图片
在 链接
前面加入感叹号 !
即可插入图片。 例如:
![服装设计](./1.jpg "这是一款女童时装")
如果在图像后面添加一个 URL 即可实现图片链接。 例如:
[![百度](./baidu.jpg "搜索引擎")](https://www.baidu.com)
注意: 图片地址可以使用绝对路径或者相对路径。
转义字符
可以使用反斜杠 \
转义以下 Markdown 字符:
序号 | 字符 | 名称 |
---|---|---|
1 | \ | 反斜杠 |
2 | ` | 反引号 |
3 | * | 星号 |
4 | _ | 下划线 |
5 | {} | 大括号 |
6 | [] | 中括号 |
7 | () | 小括号 |
8 | # | 井号 |
9 | + | 加号 |
10 | - | 减号(连字符) |
11 | . | 点 |
12 | ! | 感叹号 |
13 | | | 管道符 |