markdown语法全集

📘 Markdown 语法完全手册
Markdown 是一种轻量级标记语言，让你用纯文本写出带格式的文档。下面是几乎所有常用语法。
一、基础语法
1. 标题（Heading）
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
⚠️ # 和文字之间需要空格，最多支持六级标题。
2. 段落与换行
这是一个段落。
这是另一个段落（中间空一行）。
同一行末尾加两个空格
即可强制换行。
3. 文字样式
**粗体**（推荐）
*斜体*（推荐）
***粗斜体***
~~删除线~~
<u>下划线</u>（需 HTML 支持）
`行内代码`
效果： 粗体、斜体、粗斜体、删除线、行内代码
4. 引用
> 这是一级引用
>> 这是嵌套引用
>>> 这是三级嵌套引用
效果：
这是一级引用
这是嵌套引用
5. 分割线
---
***
___
二、列表
1. 无序列表
- 项目一
- 项目二
- 子项目 2.1
- 子项目 2.2
- 三级子项
* 星号也可以
+ 加号也可以
项目一
项目二
子项目 2.1
2. 有序列表
1. 第一项
2. 第二项
1. 嵌套第一项
2. 嵌套第二项
3. 第三项
第一项
第二项
3. 任务列表（Task List）
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个任务
[x] 已完成的任务
[ ] 未完成的任务
三、链接与图片
1. 链接
[行内链接](https://www.example.com)
[带标题的链接](https://www.example.com "鼠标悬停提示")
[引用式链接][标记]
[标记]: https://www.example.com
自动链接：<https://www.example.com>
2. 图片
![引用式图片][图片标记]
[图片标记]: https://example.com/logo.png
3. 可点击图片（HTML 方式）
<a href="https://www.example.com">
<img src="logo.png" alt="点击跳转" width="200"/>
</a>
四、代码
1. 行内代码
使用 `npm install` 安装依赖
2. 代码块（围栏式，推荐）
```python
def hello():
print("Hello, Markdown!")
```
效果：
def hello():
print("Hello, Markdown!")
3. 支持的常见语言标识
python javascript typescript java c cpp csharp go rust php ruby swift kotlin sql bash shell powershell json yaml xml html css markdown diff mermaid 等
4. 显示 Markdown 源码本身
外层用更多反引号包裹：
````markdown
```python
print("hello")
```
````
5. diff 高亮
```diff
+ 新增的行
- 删除的行
```
五、表格
| 左对齐列 | 居中对齐列 | 右对齐列 |
|:---------|:----------:|---------:|
| 内容 | 内容 | 内容 |
| 较长的内容 | 内容 | 内容 |
效果：
💡 第二行的冒号位置控制对齐方式：:--- 左对齐、:---: 居中、---: 右对齐。
六、高级语法
1. 脚注
这是一个带脚注的句子[^1]，另一个脚注[^注]。
[^1]: 这是脚注的内容。
[^注]: 脚注也可以用文字标记。
2. 定义列表（部分渲染器支持）
Markdown
: 轻量级标记语言
GitHub
: 代码托管平台
3. 缩写（部分渲染器支持）
*[HTML]: HyperText Markup Language
HTML 是一种标记语言。
4. 目录自动生成
[TOC]
5. 数学公式（KaTeX / MathJax）
行内公式：$E = mc^2$
块级公式：
$$
\int_{a}^{b} f(x)\,dx = F(b) - F(a)
$$
6. Emoji 表情
:smile: :heart: :+1: :rocket:
也可以直接输入 😀 ❤️ 👍
常用对照：
:smile: → 😄
:fire: → 🔥
:tada: → 🎉
:100: → 💯
七、Mermaid 图表（扩展语法）
需要渲染器支持（如 GitHub、Typora、GitLab）。
1. 流程图
```mermaid
flowchart LR
A[开始] --> B{判断}
B -- 是 --> C[执行]
B -- 否 --> D[结束]
C --> D
```
2. 时序图
```mermaid
sequenceDiagram
用户->>服务器: 发起请求
服务器-->>数据库: 查询
数据库-->>服务器: 返回数据
服务器-->>用户: 响应
```
3. 甘特图
```mermaid
gantt
title 项目计划
section 阶段一
任务A :a1, 2024-01-01, 30d
任务B :after a1, 20d
```
4. 其他支持的图
pie（饼图）
classDiagram（类图）
stateDiagram（状态图）
erDiagram（ER 图）
gitGraph（Git 提交图）
timeline（时间线）
mindmap（思维导图）
八、HTML 扩展语法
Markdown 原生支持嵌入 HTML，可实现更复杂的排版。
1. 折叠面板
<details>
<summary>点击展开查看详情</summary>
这里是被折叠的内容，**支持 Markdown**。
</details>
2. 居中 / 文字颜色 / 字号
<center>居中文字</center>
<span style="color: red;">红色文字</span>
<span style="color: #0984e3; font-size: 18px;">自定义颜色和大小</span>
3. 键盘按键样式
按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制
效果：按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制
4. 图片控制大小
<img src="logo.png" width="300" height="200" alt="描述"/>
<!-- 用 HTML 链接可点击跳转 -->
<a href="https://example.com">
<img src="banner.png" alt="点击跳转"/>
</a>
5. 锚点跳转（页内目录）
## 章节标题 {#custom-anchor}
跳转到[章节标题](#custom-anchor)
或利用 GitHub 自动生成的锚点：
[跳到标题](#一基础语法)
九、转义字符
如果需要显示 Markdown 语法符号本身，用反斜杠 \ 转义：
\* 不是斜体 \*
\# 不是标题
\` 不是代码
\| 不是表格分隔
效果：* 不是斜体 *
十、速查表
附：不同平台的支持差异
💡 建议：写文档时优先使用基础语法保证兼容性，高级语法（Mermaid、公式、HTML）根据发布平台酌情使用。
一句话总结：标题用 #，列表用 -，粗体 **，代码 `，表格用 |，引用用 >——掌握这些已能覆盖 90% 的写作场景。
需要我针对某个具体平台（如 GitHub README、公众号排版）给出专门的写作技巧吗？