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

# URL Scheme

> 使用 Craft 的 URL Scheme 來自動化工作流程並與其他應用整合。

URL Scheme 允許使用者以及其他應用的開發者向 Craft 發送命令。此頁說明其運作方式以及目前可用的功能。

<Info title="注意">
  我們計劃在未來擴充現有功能。
</Info>

## 可用的命令

以下是 Craft 可理解的可用命令：

* 開啟文件
* 建立文件
* 附加至現有文件
* 在空間中開始搜尋
* 存取每日筆記

## 開啟頁面

**輸入：**

* **blockId** – 在文件中點擊「複製深層連結（Copy Deeplink）」即可取得，連結中會帶有 blockId 參數
* **spaceId** – 通常為你的空間 ID（隨機 GUID）；若為共享空間，請透過點擊「複製深層連結」來取得

**範例：**

```
craftdocs://open?spaceId=<spaceId>&blockId=<blockId>
```

<Warning title="警告">
  如果你不是該空間的成員則無法使用此功能。
</Warning>

## 開啟空間

**輸入：**

* **spaceId** – 可以從深層連結取得，點擊「複製深層連結」
* **(optional) tab** – `calendar` **或** `search` **或** `documents`

**範例：**

```
craftdocs://openspace?spaceId=<spaceId>&tab=<tab>
```

<Warning title="警告">
  如果你不是該空間的成員則無法使用此功能。
</Warning>

## 建立新的空白文件

**輸入：**

只要使用下列 URL，即可在目前開啟的空間中建立新的空白文件：

```
craftdocs://createnewdocument
```

## 建立文件

**輸入：**

* **spaceId** – 可以從深層連結取得，點擊「複製深層連結」
* **content** – 百分比編碼的 Markdown（目前尚未支援圖片）
* **title** – 百分比編碼的純文字標題
* **folderId** – 此參數為必填，但可以為空值

**範例：**

```
craftdocs://createdocument?spaceId=<spaceId>&title=<title>&content=<content>&folderId=<folderId>
```

## 附加至文件

**輸入：**

* **spaceId** – 可以從深層連結取得，點擊「複製深層連結」
* **index** – 新增區塊的索引（0 表示插入於最前端；使用非常大的數字則會附加於最後端，超過文件中現有區塊數）
* **parentBlockId** – 父區塊的 blockId
* **content** – 百分比編碼字串

**範例：**

```
craftdocs://createblock?parentBlockId=<parentBlockId>&spaceId=<spaceId>&content=<content>&index=<index>
```

## 在空間中搜尋

在指定的空間中啟動搜尋，並將查詢內容預先填入搜尋欄位。

**輸入：**

* **spaceId** – 可以從深層連結取得，點擊「複製深層連結」
* **query** – 請確保已進行百分比編碼

**範例：**

```
craftdocs://opensearch?spaceId=<spaceId>&query=<query>
```

## 存取每日筆記

* **昨天** – `craftdocs://openByQuery?query=yesterday&spaceId=<spaceId>`
* **今天** – `craftdocs://openByQuery?query=today&spaceId=<spaceId>`
* **明天** – `craftdocs://openByQuery?query=tomorrow&spaceId=<spaceId>`

## 相關文章

<CardGroup cols={2}>
  <Card title="Craft API" href="/zh-Hant/integrate/api">
    整合 Craft 的完整 REST API 文件
  </Card>

  <Card title="iOS Shortcuts" href="/zh-Hant/integrate/apple-shortcuts">
    使用 Apple Shortcuts 在 iOS 上自動化 Craft
  </Card>

  <Card title="深層連結（使用者指南）" href="/zh-Hant/organize-and-find/linking/deeplinks">
    學習如何在工作流程中使用深層連結
  </Card>
</CardGroup>