> ## 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.

# 文档、页面和块

> 了解 Craft 的构建模块以及它们如何创建灵活的文档结构。

Craft 使用三个核心概念来组织你的内容：块、页面和文档。理解它们如何协作，可以帮助你充分利用 Craft 灵活的结构。

<iframe src="https://www.youtube-nocookie.com/embed/LBk28cRY-nk" title="Documents, Pages, and Blocks Introduction" className="w-full aspect-video rounded-xl" allowFullScreen />

## 了解块

Craft 中的每一段都是一个 **块**。每个块可以包含自己的内容，并具有双重用途：

* 作为当前页面上的一段文本或内容
* 作为通往具有自己嵌套内容的更深层页面的标题/入口

这种简单的结构让你在写作时自然地创建层级。

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/blocks-diagram.png?fit=max&auto=format&n=4lRkwRvDwE7Wr43k&q=85&s=13909325bc4d8dd5856412229a7186a4" alt="显示块作为文档构建模块的示意图" width="3104" height="1838" data-path="images/introduction/documents/en/content/blocks-diagram.png" />

## 了解页面

当一个块包含嵌套内容时，它会成为一个 **页面**。页面可以像任何普通块一样设置样式，点击它们即可进入查看其内容。

<Info title="页面样式">
  “Page” 文本样式选项（以及 “Card” 样式）专为包含嵌套内容的块设计，使它们在视觉上作为入口点更为明显。
</Info>

## 了解文档

**文档** 是 Craft 中的顶层文件，类似传统的数字文件。你可以：

* 将它们标星以便快速访问
* 将它们移入文件夹
* 对它们进行排序和整理
* 删除它们（它们会被移到最近删除）

## 在文档之间移动块

你可以通过在文档和页面之间移动块来重新组织内容。

**剪切与粘贴：** 使用标准的剪切/粘贴操作来移动块。

**拖放（macOS）：** 在同一 空间 中打开两个 Craft 窗口，然后将块从一个窗口拖放到另一个窗口。

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/moving-blocks.gif?s=68c430bc44eb678592413ad23acdc41a" alt="在独立窗口间拖动块以移动文档" width="600" height="452" data-path="images/introduction/documents/en/content/moving-blocks.gif" />

<Info title="块链接保留">
  当在同一 空间 内移动块时，所有块链接都会被保留并继续正常工作。
</Info>

## 将块分组为页面

将多个块转换为嵌套页面，以在文档中创建更清晰的结构。

<Tabs>
  <Tab title="macOS">
    <Steps>
      <Step>
        选择要分组的块（点击并拖动，或 Shift+点击）。
      </Step>

      <Step>
        右键点击选中区域并选择 **Group**，或按 `⌘ (Command) + G`。
      </Step>

      <Step>
        这些块现在被嵌套到一个新的父块下，该父块充当一个页面。
      </Step>
    </Steps>

    <img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/grouping-mac.gif?s=1bef1ce9b1dfb7c17bf8480b649b5f2c" alt="在 macOS 上使用右键菜单对块进行分组" width="600" height="513" data-path="images/introduction/documents/en/content/grouping-mac.gif" />
  </Tab>

  <Tab title="iOS">
    <Steps>
      <Step>
        使用滑动手势选择多个块。
      </Step>

      <Step>
        轻触出现的 **Group** 操作。
      </Step>

      <Step>
        这些块现在被分组到一个新的父页面下。
      </Step>
    </Steps>

    <img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/grouping-ios.gif?s=a44814bcfd736a734d3d4ff89c4e4b7d" alt="在 iOS 上使用滑动手势对块进行分组" width="600" height="417" data-path="images/introduction/documents/en/content/grouping-ios.gif" />
  </Tab>
</Tabs>

## 注意事项

<Warning title="页面与文档">
  页面（文档内的嵌套内容）被视为块，而不是独立的文档。如果删除，它们不会进入最近删除。你可以：

  * 使用 **Undo**（`⌘ + Z`）在删除后立即撤销
  * 使用版本历史恢复父文档的早期版本
</Warning>

## 入门

Craft 的设计注重直观。**直接开始写作**，像平常一样。当你的文档变得过长或需要更细的结构时，你会自然而然地通过将相关块分组来发现页面的用法。

<CardGroup cols={2}>
  <Card title="管理文档" href="/zh-Hans/introduction/documents/manage">
    了解如何创建、删除和组织文档
  </Card>

  <Card title="文档组织" href="/zh-Hans/organize-and-find">
    探索用于组织内容的文件夹、标签和 空间
  </Card>
</CardGroup>