# 飞书文档排版规则

## 飞书文档块类型

根据观察，飞书文档的块类型：

| block_type | 说明 |
|-----------|------|
| 1 | Page（页面）|
| 2 | Text（文本块）|
| 3 | Heading1（一级标题）|
| 4 | Heading2（二级标题）|
| 5 | Heading3（三级标题）|
| 6 | Bulleted List（无序列表）|
| 7 | Numbered List（有序列表）|
| 8 | To-do（待办事项）|
| 9 | Quote（引用）|
| 10 | Code（代码块）|
| 11 | Divider（分隔线）|
| 34 | Quote Container（引用容器）|

## 排版最佳实践

### 1. 标题层级
- 使用 Heading2/Heading3 来组织内容结构
- 避免太多层级，保持清晰

### 2. 列表使用
- 无序列表（type 6）用于列举项目
- 有序列表（type 7）用于步骤说明

### 3. 分隔线
- 使用 Divider（type 11）来分隔大的内容区块

### 4. 引用
- 使用 Quote（type 9）或 Quote Container（type 34）来强调重要内容

### 5. 文本格式
- 善用加粗、斜体等文本样式
- 保持整体排版简洁美观

## 更新飞书文档的注意事项

⚠️ **重要：不要直接用 write 覆盖整个文档！**

**推荐做法：**
1. 先用 list_blocks 查看当前文档结构
2. 用 update_block 逐个更新需要修改的块
3. 或者如果必须重写，要确保保持原来的块结构和格式

**避免：**
- ❌ 直接用 write 方法覆盖整个文档（会丢失所有格式）
- ❌ 把所有内容都放在一个 Text 块里
