【MarkDown】MarkDown 常用语法

MarkDown 常用语法

1. 标题

markdown 复制代码

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

补充说明：
标题层级建议不超过四级，避免结构过深

标题后最好跟一个空行，否则可能被解析为普通文本
另一种写法（Setext风格，仅支持一二两级）：
markdown 复制代码
一级标题
=========
二级标题
---------

2. 段落与换行

写法	效果	说明
两个段落之间空一行	新段落	标准做法
行尾加两个空格 + 回车	换行但不分段	容易遗漏，不推荐
行尾加 `<br>`	显式换行	推荐，语义清晰
连续多个空行	等同于一个空行	多余空行会被忽略

示例：

markdown 复制代码

这是第一段。[空格][空格]
这是同一段的新一行（不推荐）

这是第二段。<br>
这也是第二段的新一行（推荐）

3. 文字样式

语法	效果	备注
`斜体` 或 `_斜体_`	斜体	推荐用 `*`
`粗体` 或 `__粗体__`	粗体	推荐用 `**`
`*粗斜体*`	粗斜体	三者可组合
`~~删除线~~`	删除线	GFM扩展
`行内代码`	`行内代码`	反引号包围
`<u>下划线</u>`	++下划线++	需用HTML
`==高亮==`	高亮	部分解析器支持（如Typora）
`H~2~O`	H₂O	下标（需扩展）
`X^2^`	X²	上标（需扩展）

4. 列表

无序列表

markdown 复制代码

- 项目1
* 项目2（星号亦可）
+ 项目3（加号亦可）
  - 子项目（缩进2或4空格）
    - 更深一层

有序列表

markdown 复制代码

1. 第一项
2. 第二项
   1. 子项2.1（数字可重置，显示自动）
   2. 子项2.2
3. 第三项

混合列表

markdown 复制代码

1. 有序其一
   - 无序子项
   - 另一子项
2. 有序其二
   - [x] 已完成任务（嵌套任务列表）

列表间的空行

markdown 复制代码

- 项目A

  这是项目A的说明段落（需缩进与首行对齐）

- 项目B

带空行时，会生成 <p> 段落标签；不带空行则直接续写文本。

5. 链接

类型	语法	示例
行内链接	`[文字](URL)`	`[Google](https://google.com)`
带标题的链接	`[文字](URL "标题")`	`[Google](https://google.com "搜索引擎")`
引用式链接	`[文字][标签]` + 底部 `[标签]: URL`	便于复用
自动链接	`<URL>`	`<https://example.com>`
锚点链接	`[跳转](#章节名)`	`[跳转](#标题)`

引用式链接示例：

markdown 复制代码

[Google][1] 和 [Bing][2] 都是搜索引擎。

[1]: https://google.com
[2]: https://bing.com "必应"

锚点规则 ：标题中的中文会URL编码；空格用-代替；英文全小写。

markdown 复制代码

[跳转到第3章](#第3章)

6. 图片

语法	说明
`![替代文字](图片URL)`	基本用法
`![替代文字](图片URL "悬停文字")`	带标题
`[![替代文字](图片URL)](点击跳转URL)`	图片带链接
`<img src="URL" width="300">`	设置尺寸（需HTML）

markdown 复制代码

![Logo](logo.png)

[![点击图片](thumb.jpg)](https://example.com/large.jpg)

7. 引用（Blockquote）

markdown 复制代码

> 这是引用
> 可以多行

> 段落1
>
> 段落2（中间空行）

> 外层引用
>> 嵌套引用（二级）
>>> 三级引用

引用中可混用其他语法：

markdown 复制代码

> ## 引用的标题
> 
> - 列表项
> - **粗体** 和 `代码`
>
> ```
> 代码块也可
> ```

8. 代码块

常用语言标识

语言	标识	语言	标识
Python	`python`	JavaScript	`javascript` 或 `js`
Bash	`bash` 或 `sh`	C/C++	`c` 或 `cpp`
Java	`java`	Go	`go`
Rust	`rust`	SQL	`sql`
JSON	`json`	YAML	`yaml`
HTML	`html`	CSS	`css`

markdown 复制代码

```python
def hello():
    print("Hello, World!")

复制代码

### 代码块行号（需解析器支持）
部分渲染器支持行号，如GitHub默认不显示，Typora可配置。

---

## 9. 表格

```markdown
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 单元格1 | 单元格2  | 单元格3 |
| 内容    | 内容     | 内容    |

高级表格技巧：

单元格内换行：使用 <br>
单元格内列表：需用HTML标签 <ul><li>
空单元格：直接留空 | |
列对齐：标题行下方 |---| 的冒号位置决定

markdown 复制代码

| 名称 | 描述 |
|:---|:---|
| 项目A | 第一行<br>第二行 |
| 项目B | <ul><li>列表项</li></ul> |

10. 分隔线

markdown 复制代码

---
***
___

注意：分隔线前后建议各空一行，否则可能被误解析为标题的底线。

11. 转义字符

常用需转义字符：

复制代码

\ * _ { } [ ] ( ) # + - . ! ` | < > @ ~ $

示例：

markdown 复制代码

\*不是斜体\*
\_也不是斜体\_
\# 不是标题

12. 任务列表（GitHub Flavored Markdown）

markdown 复制代码

- [ ] 未完成
- [x] 已完成
- [X] 已完成（大写X亦可）
  - [ ] 嵌套任务

注意：- 后必须有空格，[ ] 中间必须有空格，[x] 中间是字母x。

13. 内嵌HTML

常用可用HTML标签：

标签	用途
`<kbd>Ctrl</kbd>`	键盘按键
`<sup>` / `<sub>`	上标/下标
`<details><summary>标题</summary>内容</details>`	折叠块
`<center>居中</center>`	居中（部分支持）
`<span style="color:red">彩色文字</span>`	颜色（需CSS支持）

折叠块示例：

markdown 复制代码

<details>
<summary>点击展开</summary>

隐藏的内容，支持**Markdown**。
- 列表项

</details>

14. 目录（TOC）

手动目录

markdown 复制代码

- [标题1](#标题1)
- [标题2](#标题2)
  - [子标题2.1](#子标题21)

自动目录（部分编辑器支持）

Typora：[toc]
VS Code（Markdown All in One）：右键「创建目录」

15. 脚注（部分解析器支持）

markdown 复制代码

这里需要脚注[^1]。

[^1]: 这是脚注的说明文字。

16. 定义列表（部分解析器支持）

markdown 复制代码

术语
: 定义内容

另一个术语
: 定义第一段

: 定义第二段

17. Emoji（GFM支持）

markdown 复制代码

:smile: :heart: :rocket: :python:

显示为：😄 ❤️ 🚀 🐍

常用Emoji代码可参考 gist.github.com

18. 数学公式（需解析器支持，如Typora、Jupyter）

markdown 复制代码

行内公式：$E = mc^2$

块级公式：
$$
\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

19. 图表（Mermaid，部分解析器支持）

markdown 复制代码

```mermaid
graph TD
    A[开始] --> B{判断}
    B -->|是| C[执行]
    B -->|否| D[结束]
```

20. 最佳实践速查

场景	推荐做法
换行	优先用 `<br>` 而不是两个空格
标题	与正文之间空一行
列表	子项缩进2空格（兼容性强）
表格	对齐线用 `:---` `:---:` `---:`
代码块	始终指定语言
链接文字	具有描述性，避免「点击这里」
图片	始终提供替代文字
分隔线	前后空行，避免歧义