Markdown 详细语法大全
Markdown 是一种轻量级标记语言,语法简洁易记,广泛用于写作、文档、博客、GitHub 等场景。以下从基础、进阶、扩展、HTML 兼容四方面,整理完整可直接使用的语法(含代码与效果)。
一、基础语法(必学,覆盖 80% 场景)
1. 标题(1–6 级)
用 # 开头,# 数量 = 标题级别(1 级最大,6 级最小),# 后必须加空格。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
# 一级标题(底线写法)
====================
## 二级标题(底线写法)
--------------------
2. 文本样式
*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___
~~删除线~~
<u>下划线(HTML)</u>
==高亮==(部分编辑器支持)
效果:斜体、粗体、粗斜体、删除线、下划线、==高亮==
3. 段落与换行
- 段落:直接写,段落间空一行
- 强制换行:行尾加 2 个空格 + 回车 或
<br>
第一行(结尾加2空格)
第二行
第三行<br>第四行
4. 引用(支持嵌套)
用 > 开头,多层嵌套用 >>、>>>
> 一级引用
>> 二级嵌套引用
>>> 三级嵌套引用
>
> 引用内可以**加粗**、[链接](/)、列表
> 1. 有序
> - 无序
5. 列表
无序列表
用 -、*、+ 任一符号 + 空格
- 项目1
- 项目2
- 子项(缩进2空格/制表符)
- 子项
* 项目3
有序列表
数字. 空格(数字不影响实际排序)
1. 第一项
2. 第二项
1. 子项
2. 子项
3. 第三项
任务列表(GitHub 风格)
- [x] 已完成
- [ ] 未完成
- [ ] 待办事项
6. 代码
行内代码
用反引号 ` 包裹
执行 `npm install` 安装依赖
效果:执行 npm install 安装依赖
代码块(语法高亮)
三个反引号 ``` 包裹,开头指定语言(python/js/java/cpp 等)
```python
def hello():
print("Hello Markdown")
```
7. 链接
// 内联链接
[显示文本](URL "鼠标悬停标题")
[百度](https://www.baidu.com "百度一下")
// 引用式链接(适合重复使用)
[谷歌][1]
[1]: https://www.google.com "Google"
// 自动链接
<https://www.example.com>
<user@mail.com>
8. 图片
语法与链接类似,开头加 !
// 内联


// 引用式
![图1][img1]
[img1]: ./pic.jpg "图片说明"
// 图片+链接(把图片语法放进链接括号)
[](https://example.com)
9. 分割线
一行用 ---/***/___(3个以上,可中间加空格)
---
***
___
- - -
二、进阶语法(表格、脚注、定义列表)
1. 表格
- 用
|分隔列,-分隔表头与内容 :控制对齐:左(默认)、:---左、:---:中、---:右
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容1 | 内容2 | 内容3 |
| **长文本** | *斜体* | ~~删除~~ |
2. 脚注
文本内容[^1]
更多内容[^2]
[^1]: 脚注1说明
[^2]: 脚注2说明(支持**多行**与格式)
3. 定义列表
术语1
: 定义1
: 定义2
术语2
: 定义内容
三、扩展语法(常用编辑器/GitHub 支持)
1. 目录 TOC
@[toc] // 多数编辑器/博客
[[toc]] // VuePress、GitBook
2. 数学公式(LaTeX)
// 行内
$E=mc^2$,$\sin^2x+\cos^2x=1$
// 块级
$$
\sum_{i=1}^n a_i = \int_0^\infty f(x)dx
$$
3. 流程图/时序图(Mermaid)
```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]
```
4. 表情符号
:emoji名称:
:smile: :star: :rocket: :heavy_check_mark:
效果:😄 ⭐ 🚀 ✅
四、HTML 兼容(复杂排版)
Markdown 支持直接写 HTML 标签:
<span style="color:red;">红色文字</span>
<p align="center">居中段落</p>
<div style="font-size:20px;">大号字体</div>
<br> <hr> <kbd>Ctrl</kbd> <mark>高亮</mark>
五、转义字符
特殊符号(# * ~ [ ] ( ) 等)前加 \ 显示原字符:
\# 不是标题
\* 不是斜体
\` 显示反引号
六、速记清单
- 标题:
# - 加粗:
** ** - 斜体:
* * - 代码:
` `/ - 链接:
[ ]( ) - 图片:
 - 列表:
-/1. - 引用:
> - 表格:
| | - 分割线:
---
要不要我帮你整理一份可直接复制的 Markdown 语法速查表(PDF/MD 版)?
正文完