Markdown 常用语法速查手册

本文档整理了 Markdown 核心语法，涵盖基础排版、进阶功能及实用技巧，适合日常写作、文档编写（如 Git 命令文档）、博客创作等场景，可直接复制使用。

一、基础排版：文本样式与结构

1. 标题（分级标题）

用 # 表示标题级别，# 数量越多，层级越低（1-6 级），# 后必须加空格。

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

2. 段落与换行

段落：直接写文字，段落间空 1 行即可（无需手动缩进）。
强制换行：在一行末尾加 2 个空格 + 回车（直接回车视为同一段）。

这是一个段落。
结尾加两个空格+回车  
即可强制换行。

3. 文本强调（斜体/加粗/加粗斜体）

用 * 或 _ 包裹文字，符号前后无空格。

*斜体*   _同样斜体_  
**加粗** __同样加粗__  
***加粗斜体*** ___同样___

4. 列表（有序/无序/嵌套）

（1）无序列表

用 */+/- 开头（三者效果一致），嵌套需在子项前加 4 个空格 或 1 个 Tab。

- 苹果
- 香蕉
  - 青香蕉   ← 前面 4 个空格或 1 个 Tab
  - 熟香蕉

（2）有序列表

用 数字 + . + 空格 开头，嵌套规则同无序列表。

1. 第一步
2. 第二步
   1. 子步骤 A
   2. 子步骤 B

5. 引用（引用外部内容）

用 > 开头，支持多层嵌套（每多一层加一个 >），段落间空行需重新加 >。

> 一级引用
>> 二级嵌套
>>> 三级嵌套

二、进阶功能：代码、链接、图片、表格

1. 代码展示（行内代码/代码块）

（1）行内代码

用 反引号（键盘左上角，Tab 键上方）包裹，适合嵌入句子中的短代码（如命令、变量）。

使用 `pnpm install` 安装依赖。

（2）代码块

用 ``` 包裹，```` 后加 语言名（如 bash、python、html）可实现语法高亮，适合多行代码。

# 查看 Node 版本
node -v

def hello(name):
    print(f"Hello, {name}!")

纯文本块，不做高亮

3. 图片（网络图片/本地图片）

格式：![图片加载失败提示文字](图片地址 "可选 hover 提示")。

![Alt 描述](https://example.com/pic.jpg "鼠标悬停提示")

4. 表格（规整数据对比）

用 | 分隔列，- 分隔表头与内容（- 无需严格对齐，Markdown 自动排版），可选添加对齐方式（:--- 左对齐、---:右对齐、:---:居中）。

| 功能   | 快捷键 | 说明        |
| :----- | :----: | :---------- |
| 复制   |  Ctrl+C  | 复制选中内容 |
| 粘贴   |  Ctrl+V  | 粘贴板内容  |

三、实用技巧：贴合文档/博客场景

1. 注释（仅编辑时可见，页面不显示）

用  包裹，适合记录编辑思路，不影响页面渲染。

<!-- 这是一段注释，仅编辑时可见 -->

2. 分隔线（分割内容区块）

用 --- 或 *** 或 ___（单独一行，前后空行），适合分割章节或内容块。

上面内容

---  <!-- 分隔线 -->

下面内容

---

3.2 链接示例

Github 官网

[Github 官网](https://github.com)

四、工具推荐：验证语法与预览

在线工具：Markdown Live Preview（实时预览，边写边看）
本地编辑器：Typora（所见即所得）、VS Code（安装「Markdown All in One」插件）
博客场景：修改博客文档时，可先用本地编辑器预览，避免格式错乱。

Markdown常用语法