本文涵盖了 Markdown 的全部常用语法,每个示例均包含渲染效果与源码。
标题
以下展示了各级标题的渲染效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落与换行
这是一段普通的文本。
这是第二段,段与段之间空一行分隔。
同一段落内可以用两个以上空格来手动换行。
就像这样。
这是一段普通的文本。
这是第二段,段与段之间空一行分隔。
同一段落内可以用两个以上空格来手动换行。
就像这样。
文字样式
加粗文本
斜体文本
加粗且斜体
删除线
**加粗文本**
*斜体文本*
***加粗且斜体***
~~删除线~~
行内代码
使用反引号包裹 inline code 即可。
用双反引号包裹含反引号的内容:code with ` backtick。
使用反引号包裹 `inline code` 即可。
用双反引号包裹含反引号的内容:``code with ` backtick``。
代码块
支持多种语言的语法高亮:
function greet(name) {
console.log('Hello, ' + name + '!')
}
def greet(name):
print(f'Hello, {name}!')
<div class="box">Hello World</div>
```javascript
function greet(name) {
console.log('Hello, ' + name + '!')
}
```
```python
def greet(name):
print(f'Hello, {name}!')
```
```html
<div class="box">Hello World</div>
```
无序列表
- 列表项一
- 列表项二
- 列表项三
也可以用 * 或 +:
-
星号列表
-
加号列表
- 列表项一
- 列表项二
- 列表项三
* 星号列表
+ 加号列表
有序列表
- 第一项
- 第二项
- 第三项
1. 第一项
2. 第二项
3. 第三项
嵌套列表
- 水果
- 苹果
- 香蕉
- 饮料
- 咖啡
- 茶
- 水果
- 苹果
- 香蕉
- 饮料
1. 咖啡
2. 茶
任务列表
- 已完成的任务
- 未完成的任务
- 另一个未完成的任务
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个未完成的任务
引用
这是一段引用文本。 可以跨越多行。
> 这是一段引用文本。
> 可以跨越多行。
嵌套引用
外层引用
内层引用
> 外层引用
>
>> 内层引用
引用中的列表
- 引用中的列表项一
- 引用中的列表项二
> - 引用中的列表项一
> - 引用中的列表项二
链接
普通链接:GitHub
带标题的链接:Google
普通链接:[GitHub](https://github.com)
带标题的链接:[Google](https://google.com '点击跳转 Google')
自动链接:<https://www.example.com>
图片

带链接的图片(点击图片跳转):

[](https://github.com)
表格
| 姓名 | 年龄 | 城市 |
|---|---|---|
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |
| 王五 | 28 | 广州 |
带对齐方式的表格:
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| Left | Center | Right |
| 左 | 中 | 右 |
| 姓名 | 年龄 | 城市 |
| ------ | ---- | ------ |
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |
| 王五 | 28 | 广州 |
带对齐方式的表格:
| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| Left | Center | Right |
| 左 | 中 | 右 |
分隔线
使用三个或更多的 -、* 或 _:
以上是一条分隔线。
---
转义字符
使用反斜杠转义 Markdown 特殊字符:
* 这不是斜体 * # 这不是标题 ` 这不是代码
\* 这不是斜体 \*
\# 这不是标题
\` 这不是代码
锚点链接
可以创建指向页面内标题的锚点:
跳转到 标题
跳转到 [标题](#标题)