深度链接

创建可直接在 Craft 应用中打开文档、页面或特定块的直接链接。

​

什么是深度链接？

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

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

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

深度链接仅适用于 Craft 的 macOS、iOS 和 iPad。

​

获取深度链接

macOS

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

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

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

iOS

在 iOS 和 iPadOS 上，你可以按照以下步骤获取深度链接：

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

1. 轻点右上角的分享图标打开分享菜单

2. 选择导出为

   
3. 向下滚动到高级并轻点复制深度链接

   

​

使用深度链接

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

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

​

Markdown 深度链接

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

例如：

[项目笔记](craftdocs://open?spaceId=<spaceId>&blockId=<blockId>)

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

深度链接仅对有权限编辑该空间的人有效。与协作者分享深度链接之前，请确保他们是该空间的成员。