> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 缩进深度限制

> 了解为提升移动端可读性和文档结构而设定的 5 级缩进限制。

Craft 将块缩进限制为**5 级**，适用于所有平台。此限制可确保你的文档在屏幕空间受限的移动设备上仍然可读且结构清晰。

## 五级缩进限制

根级（无缩进）为第 0 级。在此基础上，你最多可以再缩进 5 级（第 1 级到第 5 级）。当达到第 5 级时，缩进按钮会被禁用，无法继续缩进。

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/blocks-and-pages/indent-limits/en/content/indent-limit.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=b3d2bf6e8e60880dc1df6d1afa8f668e" alt="最大缩进深度为 5 级" width="265" height="205" data-path="images/write-and-edit/blocks-and-pages/indent-limits/en/content/indent-limit.png" />

<Info title="设计决策">
  5 级限制是有意为之，而非技术限制。它鼓励更清晰的文档结构，并确保内容在所有设备上都能被访问和阅读。
</Info>

## 为什么会有这个限制

**移动端可读性**：在 iPhone 和 iPad 的屏幕上，过深的嵌套会使内容难以阅读和导航。五级提供了足够的层次感，同时保持可用性。

**文档清晰度**：极深的嵌套往往意味着结构过于复杂。该限制鼓励你将内容拆分为独立页面或重新组织，以提升清晰度。

**一致体验**：该限制在 macOS、iOS、Windows 和 Web 上保持一致，确保你的文档在各处的外观和行为相同。

## 在限制内工作的方法

如果你经常触及 5 级限制，可以考虑以下替代方案：

### 使用子页面

与其继续深度嵌套，不如创建子页面来组织相关内容。

```
Project Overview
├─ Phase 1 (subpage)
│  ├─ Task 1
│  ├─ Task 2
│  └─ Task 3
├─ Phase 2 (subpage)
│  ├─ Task 4
│  └─ Task 5
```

这样可以保持结构浅显，同时每个阶段都能拥有各自聚焦的文档。

### 重新组织内容

深度嵌套可能意味着内容应被拆分：

**而不是这样**：

```
Main Document
├─ Category A
│  ├─ Subcategory 1
│  │  ├─ Item 1
│  │  │  ├─ Detail 1
│  │  │  │  └─ Sub-detail (can't indent further!)
```

**试试这样**：

```
Main Document
├─ Category A (link to separate page)

Category A Page
├─ Subcategory 1
│  ├─ Item 1
│  │  └─ Detail 1
```

### 使用集合

对于具有许多属性的结构化数据，集合提供了比深度缩进更好的方案：

与其将客户信息嵌套到 5 级以上，不如使用带字段的集合。每一行都可以有自己的子页面，便于无限制地组织内容。

### 与折叠块配合使用

使用折叠块来隐藏复杂性，而不增加缩进深度：

```
Project Tasks
├─ High Priority
│  └─ [Toggle] 10 tasks hidden
├─ Medium Priority
│  └─ [Toggle] 15 tasks hidden
```

这样可以在需要时显示详细内容，同时保持文档结构整洁。

## 平台差异

5 级限制在所有平台上都适用，但与之交互的方式有所不同：

**macOS**：使用 `Tab` 进行缩进，使用 `Shift+Tab` 进行减少缩进。Tab 键在第 5 级时会失效。

**iOS/iPadOS**：使用工具栏中的缩进按钮或滑动手势。达到第 5 级时，缩进按钮会被禁用。

**Windows/Web**：与 macOS 类似，使用 `Tab` 和 `Shift+Tab`。

<Warning title="列表与大纲">
  此限制适用于**所有块类型**，包括文本块、任务、列表和页面。没有例外。
</Warning>

## 常见问题

**我可以请求更深的嵌套吗？**

5 级限制是为了在结构与可读性之间取得平衡。如果你需要更深的层次，建议使用子页面或集合来替代。

**这会影响集合吗？**

集合本身没有缩进限制，但集合单元格内的内容仍遵循相同的 5 级规则。

**导入的文档会怎样？**

当从其他应用导入具有更深嵌套的文档时，Craft 会将超过第 5 级的内容进行扁平化以保持该限制。

<Info title="最佳实践">
  如果你经常触及 5 级限制，这通常是你应重新考虑文档结构的信号。清晰、聚焦的文档并通过链接子页面组织内容，通常比深度嵌套的大纲更易于导航和维护。
</Info>

## 相关文章

<CardGroup cols={2}>
  <Card title="块与页面" href="/zh-Hans/write-and-edit/blocks-and-pages">
    了解 Craft 的构建单元
  </Card>

  <Card title="创建子页面" href="/zh-Hans/introduction/documents">
    使用嵌套文档来组织内容
  </Card>

  <Card title="集合" href="/zh-Hans/organize-and-find/collections">
    使用类数据库表格结构组织复杂数据
  </Card>
</CardGroup>