可读性技巧 #

好的：
## 主要内容

### 子内容

#### 详细说明

不好的：
## 内容
## 内容
## 内容（同级标题过多）

## 目录

- [简介](#简介)
- [安装](#安装)
- [使用](#使用)

## 章节1

内容...

---

## 章节2

内容...

好的：
## 功能特性

- 特性一：说明
- 特性二：说明
- 特性三：说明

不好的：
## 功能特性
特性一说明。特性二说明。特性三说明。

好的：
| 方案 | 优点 | 缺点 |
|------|------|------|
| A | 快 | 贵 |
| B | 慢 | 便宜 |

不好的：
方案A优点是快，缺点是贵。方案B优点是便宜，缺点是慢。

好的：
> **重要提示**：这是一个关键信息。

不好的：
这是一个关键信息。

好的：
这是一个**重要**的概念，需要*特别注意*。

不好的：
这是一个重要的概念，需要特别注意。

好的：
使用 `npm install` 安装依赖

不好的：
使用 npm install 安装依赖

好的：
![流程图](flow.png)
*图：系统流程图*

不好的：
![图片](1.png)

好的：
这是一个短段落。

这是另一个短段落。

不好的：
这是一个非常长的段落，包含多个观点，读者容易疲劳...

好的：
Markdown 是一种轻量级标记语言。它使用简单的语法...

不好的：
在2004年，John Gruber 创建了一种语言...

好的：
首先，安装依赖。然后，配置项目。最后，运行项目。

不好的：
安装依赖。配置项目。运行项目。

好的：
```javascript
// 获取用户信息
const user = await fetchUser(id);

// 处理数据
const processed = processData(user);

// 返回结果
return processed;

const user = await fetchUser(id);
const processed = processData(user);
return processed;

### 分步说明

```markdown
好的：
## 步骤一：安装

```bash
npm install

module.exports = { ... };

npm install

module.exports = { ... };

## 提示框

### 使用引用样式

```markdown
> **提示**：这是一个提示信息。

> **注意**：这是一个注意事项。

> **警告**：这是一个警告信息。

> [!NOTE]
> 这是一个提示。

> [!WARNING]
> 这是一个警告。

## 本节要点

1. 要点一
2. 要点二
3. 要点三

## 总结

本文介绍了：
- 内容一
- 内容二
- 内容三

下一步建议...