Markdown 语法速查

jiancai.zhong 于 2025-01-01 发布

本文涵盖了 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. 第二项
 3. 第三项

嵌套列表

 - 水果
   - 苹果
   - 香蕉
 - 饮料
   1. 咖啡
   2.

任务列表

 - [x] 已完成的任务
 - [ ] 未完成的任务
 - [ ] 另一个未完成的任务

引用

这是一段引用文本。 可以跨越多行。

 > 这是一段引用文本。
 > 可以跨越多行。

嵌套引用

外层引用

内层引用

 > 外层引用
 >
 >> 内层引用

引用中的列表

  • 引用中的列表项一
  • 引用中的列表项二
 > - 引用中的列表项一
 > - 引用中的列表项二

链接

普通链接:GitHub

带标题的链接:Google

自动链接:https://www.example.com

 普通链接:[GitHub](https://github.com)

 带标题的链接:[Google](https://google.com '点击跳转 Google')

 自动链接:<https://www.example.com>

图片

示例图片

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

示例图片

 ![示例图片](yun.png)

 [![示例图片](yun.png)](https://github.com)

表格

姓名 年龄 城市
张三 25 北京
李四 30 上海
王五 28 广州

带对齐方式的表格:

左对齐 居中对齐 右对齐
Left Center Right
 | 姓名 | 年龄 | 城市 |
 | ------ | ---- | ------ |
 | 张三 | 25 | 北京 |
 | 李四 | 30 | 上海 |
 | 王五 | 28 | 广州 |

 带对齐方式的表格:

 | 左对齐 | 居中对齐 | 右对齐 |
 | :--- | :---: | ---: |
 | Left | Center | Right |
 | 左 | 中 | 右 |

分隔线

使用三个或更多的 -*_


以上是一条分隔线。

 ---

转义字符

使用反斜杠转义 Markdown 特殊字符:

* 这不是斜体 * # 这不是标题 ` 这不是代码

 \* 这不是斜体 \*
 \# 这不是标题
 \` 这不是代码

锚点链接

可以创建指向页面内标题的锚点:

跳转到 标题

 跳转到 [标题](#标题)