> ## 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 应用中打开文档、页面或特定块的直接链接。

## 什么是深度链接？

深度链接会生成一个 URL，可直接链接到 Craft 应用内的文档、页面，甚至某个特定块 – 从系统中的任意位置点击它们，应该都会直接在 Craft 应用中打开到那个位置。

它们的格式为 `craftdocs://open...`，可在 iOS/iPadOS/macOS 上使用。它们可以与任何有权编辑该空间的人共享。

深度链接通常用于将其他应用连接回 Craft – 例如，Things 的某个项目可以在备注中放置一个链接，打开你用于记录该项目笔记的 Craft 文档。不要将它们与 Secret Links 混淆，后者会在网页中打开你的文档以供查看/评论，而不是在 Craft 编辑器中打开。

<Info title="平台可用性">
  深度链接仅适用于 Craft 的 macOS、iOS 和 iPad。
</Info>

## 获取深度链接

<Tabs>
  <Tab title="macOS">
    在 macOS 上查看文档时，点击右上角的**分享按钮**，选择**导出为**，然后滚动到**高级**并选择**复制深度链接**或**复制 Markdown 深度链接**。

    <img src="https://mintcdn.com/craft-support/yfye6QiCEES0sedn/images/organize-and-find/linking/deeplinks/en/content/deeplinks-share-menu.png?fit=max&auto=format&n=yfye6QiCEES0sedn&q=85&s=cd424b2e81bac067116acd015d7cf08d" alt="在 macOS 分享菜单中复制深度链接" width="1480" height="744" data-path="images/organize-and-find/linking/deeplinks/en/content/deeplinks-share-menu.png" />

    另外，在 macOS 上也可以从**文件**菜单中获取深度链接。

    如果在激活此功能时，你高亮了某个特定块（或正在编辑该块），那么深度链接就会指向该块。否则，链接会指向你正在查看的页面/文档。
  </Tab>

  <Tab title="iOS">
    在 iOS 和 iPadOS 上，你可以按照以下步骤获取深度链接：

    <Tip>
      在 macOS 的分享菜单中也可通过同样的**导出为 → 高级**流程来获取，你可以选择**复制深度链接**或**复制 Markdown 深度链接**。
    </Tip>

    <Steps>
      <Step>
        轻点右上角的**分享图标**打开分享菜单
      </Step>

      <Step>
        选择**导出为**

        <img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/organize-and-find/linking/deeplinks/en/content/ios-deeplink-1.png?fit=max&auto=format&n=wb5Ce6cIohLU54lt&q=85&s=5be1cbe2d6234d43cd54616e1120afe1" alt="iOS 导出菜单" width="632" height="1300" data-path="images/organize-and-find/linking/deeplinks/en/content/ios-deeplink-1.png" />
      </Step>

      <Step>
        向下滚动到**高级**并轻点**复制深度链接**

        <img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/organize-and-find/linking/deeplinks/en/content/ios-deeplink-2.png?fit=max&auto=format&n=wb5Ce6cIohLU54lt&q=85&s=216bdf58569c8480cbfa7cec75268eb1" alt="iOS 深度链接选项" width="632" height="1299" data-path="images/organize-and-find/linking/deeplinks/en/content/ios-deeplink-2.png" />
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 使用深度链接

深度链接几乎可以用于任何支持链接的地方。例如：

* 将深度链接 URL 复制并粘贴到浏览器的地址栏，会打开 Craft
* 将链接放入 Stickies 便笺中，可以让你从那里快速访问该文档
* 你可以通过 Slack 向同事发送，或通过 Messages 向联系人发送深度链接 URL，只要他们有该空间的访问权限，就能点击打开

## Markdown 深度链接

Markdown 深度链接是将相同的 Craft 深度链接按标准 Markdown 链接语法格式化后的形式。它不会显示完整的 `craftdocs://open...` URL，而是可以在支持 Markdown 的应用或文档中显示为可读文本。

例如：

```markdown theme={null}
[项目笔记](craftdocs://open?spaceId=<spaceId>&blockId=<blockId>)
```

当你希望把更简洁的链接粘贴到支持 Markdown 的应用或文档中时，请使用 Markdown 深度链接。如果你选择**复制 Markdown 深度链接**，Craft 会直接以这种格式复制该链接。Markdown 深度链接的行为与普通深度链接相同：点击链接会打开 Craft，而打开它的人仍然需要有该空间的访问权限。

<Warning title="需要访问权限">
  深度链接仅对有权限编辑该空间的人有效。与协作者分享深度链接之前，请确保他们是该空间的成员。
</Warning>
