> ## 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 단축어 동작 참조

> Apple 단축어에서 사용하는 Craft 동작의 매개변수, 기본값, 동작 방식, 반환값입니다.

iPhone, iPad, Mac의 Apple 단축어 앱에서 사용하는 Craft 동작에 대한 참조 문서입니다. 동작은 단축어에 표시되는 카테고리별로 묶여 있습니다. 동작을 펼치면 매개변수와 반환값을 확인할 수 있습니다.

문서 및 폴더 동작에서는 문서나 폴더 선택기를 열기 전에 **공간**을 선택하세요. 공간을 선택하기 전에는 선택기가 비어 있습니다. 일부 동작은 이전 동작에서 전달된 문서로 스페이스를 추론할 수 있지만, 데일리 노트를 대상으로 할 때는 스페이스를 직접 선택해야 합니다. 문서나 폴더는 해당 스페이스에 속해 있어야 합니다. 이전 결과를 사용하려면 변수 선택기로 삽입하세요.

동작에서 **문서**, **폴더**, **작업**을 요구하면 목록에서 선택하거나 이전 Craft 동작의 결과를 전달하세요. 제목을 입력하거나 링크를 붙여 넣는 방식은 작동하지 않습니다. Siri 동작은 Apple의 용어를 사용합니다. **노트**는 Craft 문서이고 **리마인더**는 Craft 작업입니다.

## 문서

<AccordionGroup>
  <Accordion title="문서 생성" id="create-document">
    스페이스에 새 문서를 만들며, 원하면 폴더 안에 만들 수 있습니다. 같은 제목의 문서가 이미 있어도 실행할 때마다 새 문서를 만듭니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 문서를 만들 스페이스입니다. |
    | **폴더** | Craft Folder | 아니요 | 미분류 | 선택한 스페이스 안의 대상 폴더입니다. 폴더 생성에서 만든 폴더를 전달할 수 있습니다. |
    | **제목** | 텍스트 | 아니요 | 비어 있음 | 문서 제목입니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 비어 있음 | 본문 내용입니다. Markdown은 서식이 적용된 Craft 블록으로 변환됩니다. |
    | **이미지** | 이미지 파일 목록 | 아니요 | 비어 있음 | 콘텐츠 다음에 본문에 추가되는 이미지입니다. 문서 커버는 설정하지 않습니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 문서를 만든 뒤 새 문서를 엽니다. |

    #### 반환값

    **Craft Document:** 새 문서입니다. 문서에 추가, 문서 이름 변경, 문서 열기에 전달할 수 있습니다.

    [생성된 제목으로 텍스트 파일 가져오기](/ko/integrate/apple-shortcuts/examples#생성된-제목으로-텍스트-파일-가져오기)에서 사용됩니다.
  </Accordion>

  <Accordion title="문서에 추가" id="add-to-document">
    문서나 페이지의 시작 또는 끝에 콘텐츠를 추가합니다. 기존 콘텐츠와 제목은 그대로 유지됩니다. 같은 콘텐츠가 이미 있어도 실행할 때마다 다시 추가합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 아니요 | 선택한 문서의 스페이스 | 대상 스페이스입니다. 대상이 데일리 노트일 때 선택하세요. |
    | **문서** | Craft Document 또는 페이지 | 예 | 없음 | 대상 문서나 페이지입니다. 이전 동작의 결과를 전달할 수 있습니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 비어 있음 | 추가할 텍스트입니다. Markdown은 서식이 적용된 Craft 블록으로 변환됩니다. |
    | **이미지** | 이미지 파일 목록 | 아니요 | 비어 있음 | 콘텐츠 다음에 추가되는 이미지입니다. |
    | **위치** | 끝에 추가 또는 앞에 추가 | 아니요 | 끝에 추가 | 대상의 끝이나 시작에 콘텐츠를 추가합니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 추가한 뒤 대상을 엽니다. |

    **일일 노트 (오늘)**, **일일 노트 (어제)**, **일일 노트 (내일)** 옵션은 단축어가 실행될 때 항상 해당 날짜를 가리킵니다. 그 데일리 노트가 아직 없으면 Craft가 만듭니다. 문서 안의 페이지에 추가하려면 페이지 찾기의 결과를 문서로 전달하세요.

    콘텐츠와 이미지가 모두 비어 있으면 아무것도 추가되지 않습니다.

    #### 반환값

    **Craft Document:** 콘텐츠가 추가된 문서입니다. 페이지에 추가한 경우 페이지나 새 블록이 아니라 상위 문서가 반환됩니다.

    [음성 인박스](/ko/integrate/apple-shortcuts/examples#음성-인박스)에서 사용됩니다.
  </Accordion>

  <Accordion title="문서 이름 변경" id="rename-document">
    문서 제목을 변경합니다. 내용과 폴더는 그대로 유지됩니다. 문서 안의 페이지나 제목 블록이 아니라 문서 전체의 이름을 변경합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 문서가 있는 스페이스입니다. |
    | **문서** | Craft Document | 예 | 없음 | 이름을 변경할 문서입니다. 문서를 선택하거나 이전 동작의 결과를 삽입하세요. |
    | **제목** | 텍스트 | 예 | 없음 | 새 제목입니다. 따옴표나 서식을 포함해 입력한 그대로 사용됩니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 변경한 뒤 문서를 엽니다. |

    데일리 노트는 문서 이름 변경의 선택기에 표시되지 않습니다.

    문서 전체가 아니라 하위 페이지를 전달하면 동작이 실패합니다.

    #### 반환값

    **Craft Document:** 이름이 변경된 문서입니다.

    [생성된 제목으로 텍스트 파일 가져오기](/ko/integrate/apple-shortcuts/examples#생성된-제목으로-텍스트-파일-가져오기)에서 사용됩니다.
  </Accordion>

  <Accordion title="문서 열기" id="open-document">
    Craft에서 문서나 페이지를 엽니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 아니요 | 선택한 문서의 스페이스 | 문서가 있는 스페이스입니다. |
    | **문서** | Craft Document 또는 페이지 | 예 | 없음 | 열 문서나 페이지입니다. |

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="데일리 노트 열기" id="open-daily-note">
    오늘, 내일, 어제 또는 특정 날짜의 데일리 노트를 엽니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 데일리 노트가 있는 스페이스입니다. |
    | **날짜** | 선택 항목 | 아니요 | 오늘 | 오늘, 내일, 어제 또는 사용자 정의 날짜입니다. |
    | **날짜 (yyyy-MM-dd)** | 텍스트 | 날짜가 사용자 정의 날짜일 때 | 없음 | 열 날짜입니다. 예: 2026-10-13. |

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="문서 이동" id="move-document">
    같은 스페이스 안의 다른 폴더로 문서를 이동합니다. 제목과 내용은 그대로 유지됩니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 문서가 있는 스페이스입니다. |
    | **문서** | Craft Document | 예 | 없음 | 이동할 문서입니다. |
    | **폴더** | Craft Folder | 아니요 | 미분류 | 대상 폴더입니다. 비워 두면 문서가 미분류로 이동합니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 이동한 뒤 문서를 엽니다. |

    문서 전체가 아니라 하위 페이지를 전달하면 동작이 실패합니다.

    #### 반환값

    **Craft Document:** 이동된 문서입니다.
  </Accordion>

  <Accordion title="문서 삭제" id="delete-document">
    문서를 휴지통으로 옮깁니다. 영구 삭제를 켜면 문서를 영구적으로 삭제합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 문서가 있는 스페이스입니다. |
    | **문서** | Craft Document | 예 | 없음 | 삭제할 문서입니다. |
    | **영구 삭제** | 부울 | 아니요 | 끔 | 끄면 문서를 휴지통으로 옮깁니다. 켜면 영구적으로 삭제합니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 삭제한 뒤 Craft를 엽니다. |

    문서 전체가 아니라 하위 페이지를 전달하면 동작이 실패합니다.

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="페이지 찾기" id="find-page">
    문서나 페이지 안에서 입력한 제목을 찾으며, 중첩된 콘텐츠도 포함합니다. 대소문자를 구분하지 않고 제목 전체를 비교하며, 다른 블록보다 페이지를 먼저 확인합니다. 각 검색에서 위에서부터 처음 일치하는 항목을 반환합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 문서가 있는 스페이스입니다. |
    | **문서** | Craft Document 또는 페이지 | 예 | 없음 | 검색할 문서나 페이지입니다. 이전 동작의 결과를 전달할 수 있습니다. |
    | **제목** | 텍스트 | 예 | 없음 | 일치시킬 제목 전체입니다. 대소문자는 구분하지 않습니다. 제목의 일부만으로는 일치하지 않습니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 찾은 뒤 일치하는 페이지나 블록을 엽니다. |

    일치하는 페이지가 없으면 페이지 찾기는 다른 블록에서 일치하는 텍스트를 찾습니다. 스페이스 전체가 아니라 선택한 문서나 페이지와 그 안에 중첩된 콘텐츠만 검색합니다. 일치하는 항목이 없으면 「하위 페이지를 찾을 수 없습니다」 오류와 함께 동작이 실패합니다.

    #### 반환값

    **Craft Document 또는 페이지:** 일치하는 블록입니다. 문서에 추가 또는 문서 열기에 전달할 수 있습니다.
  </Accordion>

  <Accordion title="문서에 하위 페이지 추가" id="add-subpage-to-document">
    문서나 페이지 안에 새 페이지를 만듭니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 아니요 | 선택한 문서의 스페이스 | 대상이 데일리 노트일 때 선택하세요. |
    | **문서** | Craft Document 또는 페이지 | 예 | 없음 | 새 페이지를 추가할 문서나 페이지입니다. 이전 동작의 결과를 전달할 수 있습니다. |
    | **제목** | 텍스트 | 예 | 없음 | 새 페이지의 제목입니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 비어 있음 | 새 페이지의 내용입니다. Markdown은 서식이 적용된 Craft 블록으로 변환됩니다. |
    | **이미지** | 이미지 파일 목록 | 아니요 | 비어 있음 | 콘텐츠 다음에 추가되는 이미지입니다. |
    | **위치** | 끝에 추가 또는 앞에 추가 | 아니요 | 끝에 추가 | 대상의 끝이나 시작에 페이지를 추가합니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 추가한 뒤 새 하위 페이지를 엽니다. |

    데일리 노트 대상은 단축어가 실행될 때 항상 해당 날짜를 가리키며, 데일리 노트가 아직 없으면 Craft가 만듭니다.

    #### 반환값

    **Craft Document:** 상위 문서가 아니라 새 하위 페이지를 가리키는 문서 값입니다. 문서나 페이지를 받는 동작에 전달할 수 있습니다.
  </Accordion>

  <Accordion title="최상위 블록 가져오기" id="get-first-level-blocks">
    문서나 페이지의 최상위 블록 텍스트를 반환합니다. 중첩된 블록은 포함되지 않습니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 문서가 있는 스페이스입니다. |
    | **문서** | Craft Document 또는 페이지 | 예 | 없음 | 읽을 문서나 페이지입니다. 이전 동작의 결과를 전달할 수 있습니다. |
    | **숫자** | 정수 | 아니요 | 모든 최상위 블록 | 위에서부터 읽을 블록 수입니다. 0이면 빈 텍스트를 반환합니다. |

    텍스트 블록만 반환됩니다. 코드, 표, 링크, 이미지, 파일은 건너뛰지만 숫자에는 포함됩니다. 문서 제목은 포함되지 않습니다.

    #### 반환값

    **텍스트:** 각 블록의 텍스트이며, 블록마다 한 줄씩입니다.
  </Accordion>
</AccordionGroup>

## 폴더

<AccordionGroup>
  <Accordion title="폴더 생성" id="create-folder">
    스페이스에 폴더를 만들며, 원하면 다른 폴더 안에 만들 수 있습니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 폴더를 만들 스페이스입니다. |
    | **이름** | 텍스트 | 예 | 없음 | 폴더 이름입니다. 비워 둘 수 없습니다. |
    | **상위 폴더** | Craft Folder | 아니요 | 없음(최상위) | 새 폴더를 만들 폴더입니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 만든 뒤 새 폴더를 엽니다. |

    #### 반환값

    **Craft Folder:** 새 폴더입니다.
  </Accordion>

  <Accordion title="폴더 열기" id="open-folder">
    Craft에서 폴더를 엽니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 폴더가 있는 스페이스입니다. |
    | **폴더** | Craft Folder | 예 | 없음 | 열 폴더입니다. |

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="폴더 이름 변경" id="rename-folder">
    폴더 이름을 변경합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 폴더가 있는 스페이스입니다. |
    | **폴더** | Craft Folder | 예 | 없음 | 이름을 변경할 폴더입니다. |
    | **이름** | 텍스트 | 예 | 없음 | 새 이름입니다. 비워 둘 수 없습니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 변경한 뒤 폴더를 엽니다. |

    #### 반환값

    **Craft Folder:** 이름이 변경된 폴더입니다.
  </Accordion>

  <Accordion title="폴더 이동" id="move-folder">
    같은 스페이스 안의 다른 폴더나 최상위로 폴더를 이동합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 폴더가 있는 스페이스입니다. |
    | **폴더** | Craft Folder | 예 | 없음 | 이동할 폴더입니다. |
    | **상위 폴더** | Craft Folder | 아니요 | 없음(최상위) | 폴더를 옮길 대상 폴더입니다. 비워 두면 최상위로 이동합니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 이동한 뒤 폴더를 엽니다. |

    #### 반환값

    **Craft Folder:** 이동된 폴더입니다.
  </Accordion>

  <Accordion title="폴더 삭제" id="delete-folder">
    폴더와 하위 폴더를 삭제합니다. 안에 있던 문서는 삭제되지 않고 상위 폴더로 이동하며, 폴더가 최상위에 있었다면 미분류로 이동합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 폴더가 있는 스페이스입니다. |
    | **폴더** | Craft Folder | 예 | 없음 | 삭제할 폴더입니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 삭제한 뒤 Craft를 엽니다. |

    기본 제공 폴더는 삭제할 수 없습니다.

    #### 반환값

    없음.
  </Accordion>
</AccordionGroup>

## 탐색

<AccordionGroup>
  <Accordion title="Craft 열기" id="open-craft">
    Craft를 엽니다. 원하면 특정 스페이스와 보기로 열 수 있습니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 아니요 | 마지막으로 사용한 스페이스 | 열 스페이스입니다. |
    | **위치** | 선택 항목 | 아니요 | 없음 | 모든 문서, 태그, 즐겨찾기, 작업 또는 달력입니다. |

    둘 다 비어 있으면 Craft는 마지막으로 보던 곳에서 열립니다.

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="열기 및 검색" id="open-and-search">
    스페이스에서 검색을 엽니다. 원하면 검색어를 미리 입력할 수 있습니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 검색할 스페이스입니다. |
    | **검색어** | 텍스트 | 아니요 | 비어 있음 | 검색어입니다. 비워 두면 검색어 없이 검색을 엽니다. |

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="Quick Entry 열기" id="open-quick-entry">
    선택한 모드로 Quick Entry를 엽니다. 원하면 텍스트를 미리 입력할 수 있습니다. 입력은 직접 마무리합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 입력 항목을 추가할 스페이스입니다. |
    | **모드** | 선택 항목 | 아니요 | 새 문서 | 새 문서, 새 작업, 일일 노트에 추가 또는 문서 끝에 추가입니다. |
    | **폴더** | Craft Folder | 아니요 | 미분류 | 새 문서를 저장할 폴더입니다. 새 문서에서만 사용됩니다. |
    | **문서** | Craft Document | 문서 끝에 추가일 때 | 새 작업은 플랫폼에 따라 다름 | 문서 끝에 추가 또는 새 작업의 대상입니다. 새 작업에서 문서를 지정하지 않으면 Mac은 Inbox를 사용하고, iPhone과 iPad는 마지막 Quick Entry 작업 위치를 사용하며 저장된 위치가 없으면 Inbox를 사용합니다. |
    | **예정일 (yyyy-MM-dd)** | 텍스트 | 아니요 | 없음 | 새 작업의 일정 날짜입니다. |
    | **날짜** | 선택 항목 | 아니요 | 오늘 | 일일 노트에 추가에 사용할 데일리 노트입니다. 오늘, 내일, 어제 또는 사용자 정의 날짜입니다. |
    | **날짜 (yyyy-MM-dd)** | 텍스트 | 날짜가 사용자 정의 날짜일 때 | 없음 | 일일 노트에 추가에 사용할 데일리 노트 날짜입니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 비어 있음 | 미리 입력할 텍스트입니다. |

    Mac에서는 Quick Entry 창이 열립니다. iPhone과 iPad에서는 Craft 안에서 Quick Entry가 열립니다. 만든 항목은 단축어로 반환되지 않습니다.

    #### 반환값

    없음.
  </Accordion>
</AccordionGroup>

## 태그

<AccordionGroup>
  <Accordion title="태그 열기" id="open-tag">
    스페이스에서 특정 태그가 달린 문서를 보여 줍니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 태그가 있는 스페이스입니다. |
    | **태그** | Craft Tag | 예 | 없음 | 열 태그입니다. 목록에서 선택하세요. |

    #### 반환값

    없음.
  </Accordion>
</AccordionGroup>

## 작업

<AccordionGroup>
  <Accordion title="작업 생성" id="create-task">
    문서나 하위 페이지의 맨 위, 또는 스페이스의 작업 Inbox에 작업을 만듭니다. 콘텐츠와 이미지는 작업 안에 추가됩니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 작업을 만들 스페이스입니다. |
    | **문서** | Craft Document 또는 페이지 | 예 | 없음 | 작업을 만들 문서나 하위 페이지, 또는 보관함입니다. 페이지 찾기나 문서에 하위 페이지 추가에서 받은 하위 페이지를 전달하면 그곳에 작업을 만듭니다. 데일리 노트 옵션은 단축어가 실행될 때 항상 해당 날짜를 가리킵니다. |
    | **제목** | 텍스트 | 예 | 없음 | 작업 텍스트입니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 비어 있음 | 작업 안에 들어갈 내용입니다. Markdown은 서식이 적용된 Craft 블록으로 변환됩니다. |
    | **이미지** | 이미지 파일 목록 | 아니요 | 비어 있음 | 콘텐츠 다음에 추가되는 이미지입니다. |
    | **일정** | 선택 항목 | 아니요 | 없음 | 없음, 오늘, 내일 또는 개인입니다. |
    | **사용자 정의 예정일 (yyyy-MM-dd)** | 텍스트 | 일정이 개인일 때 | 없음 | 일정 날짜입니다. |
    | **마감일** | 선택 항목 | 아니요 | 없음 | 없음, 오늘, 내일 또는 개인입니다. |
    | **사용자 정의 마감일 (yyyy-MM-dd)** | 텍스트 | 마감일이 개인일 때 | 없음 | 마감 날짜입니다. |
    | **리마인더** | 선택 항목 | 아니요 | 없음 | 없음, 오늘, 내일 또는 개인입니다. |
    | **사용자 정의 알림 (yyyy-MM-dd HH:mm)** | 텍스트 | 리마인더가 개인일 때 | 없음 | 리마인더 날짜와 시간입니다. |
    | **알림 시간** | 텍스트 | 리마인더가 오늘 또는 내일일 때 | 없음 | 24시간 형식의 시간입니다. 예: 09:30. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 만든 뒤 새 작업을 엽니다. |

    일정과 마감일은 날짜만 지정합니다. 리마인더는 알림을 보내므로 시간도 필요합니다.

    #### 반환값

    **Craft Task:** 새 작업입니다. 작업 상태 설정에 전달할 수 있습니다.
  </Accordion>

  <Accordion title="작업 상태 설정" id="set-task-status">
    작업을 미완료, 완료 또는 취소됨으로 표시합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 예 | 없음 | 작업이 있는 스페이스입니다. |
    | **문서** | Craft Document | 예 | 없음 | 작업이 속한 문서입니다. Inbox의 작업이면 보관함을 선택하세요. 다른 문서를 선택하면 동작이 실패합니다. |
    | **작업** | Craft Task | 예 | 없음 | 업데이트할 작업입니다. 작업을 선택하거나 이전 동작의 결과를 삽입하세요. |
    | **상태** | 선택 항목 | 아니요 | 완전한 | 미완료, 완전한 또는 취소됨입니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 업데이트한 뒤 작업을 엽니다. |

    #### 반환값

    **Craft Task:** 업데이트된 작업입니다.
  </Accordion>

  <Accordion title="작업 목록 열기" id="open-tasks-list">
    Craft에서 작업 목록 중 하나를 엽니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **공간** | Craft Space | 아니요 | 마지막으로 사용한 스페이스 | 작업을 표시할 스페이스입니다. |
    | **작업 유형** | 선택 항목 | 아니요 | 모두 | 보관함, 오늘, 예정 또는 모두입니다. |

    #### 반환값

    없음.
  </Accordion>
</AccordionGroup>

## 알림

<AccordionGroup>
  <Accordion title="알림 생성" id="create-reminder">
    문서에 연결되지 않은 Craft 알림을 만듭니다. 작업을 만드는 Siri 동작의 알림 생성과는 다릅니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **사용자** | Craft User | 예 | 없음 | 알림을 받을 계정입니다. |
    | **마감일** | 선택 항목 | 예 | 없음 | 20분 안에, 1시간 안에, 3시간 안에, 내일, 다음 주, 개인 또는 나중에 저장하기입니다. |
    | **사용자 지정 날짜 (yyyy-MM-dd HH:mm)** | 텍스트 | 마감일이 개인일 때 | 없음 | 알림 날짜와 시간입니다. |
    | **텍스트** | 텍스트 | 예 | 없음 | 알림 텍스트입니다. |
    | **앱 열기** | 부울 | 아니요 | 끔 | 만든 뒤 Craft를 엽니다. |

    나중에 저장하기는 마감일 없이 알림을 만듭니다.

    #### 반환값

    없음.
  </Accordion>
</AccordionGroup>

## Siri 동작

이 동작들은 노트, 미리 알림, 앱 내 검색에 대한 Apple의 형식을 따르므로 Siri와 Apple Intelligence에서 사용할 수 있습니다. 다른 동작처럼 단축어에 추가할 수도 있습니다. iOS, iPadOS 또는 macOS 27 이상이 필요합니다.

이 동작들에서 **노트**는 Craft 문서이고 **리마인더**는 Craft 작업입니다. 텍스트는 일반 텍스트로 추가되며 Markdown은 변환되지 않습니다. 템플릿 폴더와 그 하위 폴더의 문서는 Find Note와 노트 선택기에서 제외됩니다. 템플릿 폴더와 그 하위 폴더는 Siri 동작의 폴더 선택기에서도 제외됩니다.

<AccordionGroup>
  <Accordion title="Create Note" id="create-note">
    Craft 문서를 만듭니다. 콘텐츠에서 비어 있지 않은 각 줄은 별도의 블록이 됩니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **제목** | 텍스트 | 예 | 없음 | 문서 제목입니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 비어 있음 | 본문 텍스트입니다. |
    | **첨부파일** | 파일 목록 | 아니요 | 비어 있음 | 텍스트 다음에 추가되는 파일입니다. |
    | **즐겨찾기** | 부울 | 아니요 | 끔 | 새 문서를 즐겨찾기에 추가합니다. |
    | **폴더** | Craft Note Folder | 아니요 | 마지막으로 사용한 스페이스의 미분류 | 대상 폴더입니다. 폴더에 따라 스페이스도 정해집니다. |

    #### 반환값

    **Craft Note:** 새 문서입니다. Open Note, Update Note, Append Text to Note에 전달할 수 있습니다.
  </Accordion>

  <Accordion title="Find Note" id="find-note">
    여러 스페이스에서 Craft 문서를 찾습니다. 휴지통에 있는 문서, 숨겨진 문서, 템플릿 폴더와 그 하위 폴더의 문서는 포함되지 않습니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **Search text** | 텍스트 | 아니요 | 없음 | 제목의 일부와 일치시킵니다. 대소문자를 구분하지 않습니다. |
    | **Folder filter** | Craft Note Folder | 아니요 | 없음 | 이 폴더의 문서만 찾습니다. |
    | **Space filter** | Craft Note Account | 아니요 | 없음 | 이 스페이스의 문서만 찾습니다. |
    | **Match mode** | All 또는 Any | 아니요 | 단축어에서 설정 | 여러 필터를 결합하는 방식입니다. |
    | **Sort by** | 생성일 또는 수정일 | 아니요 | 없음 | 생성일 또는 수정일로 결과를 정렬합니다. |
    | **Sort order** | 오름차순 또는 내림차순 | 아니요 | 없음 | 정렬 방향입니다. |
    | **Limit** | 정수 | 아니요 | 일치하는 모든 항목 | 최대 결과 수입니다. |

    이 동작의 검색, 필터, 정렬 옵션은 단축어가 만들기 때문에 OS 버전에 따라 레이블이 다를 수 있습니다. 문서 내용은 검색하지 않고 제목만 검색합니다.

    #### 반환값

    **Craft Note 목록:** 일치하는 문서입니다.
  </Accordion>

  <Accordion title="Open Note" id="open-note">
    Craft 문서를 엽니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **노트** | Craft Note | 예 | 없음 | 열 문서입니다. 예를 들어 Create Note나 Find Note의 결과를 사용할 수 있습니다. |

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="Update Note" id="update-note">
    문서의 제목, 첨부파일, 즐겨찾기 또는 폴더를 변경합니다. 비워 둔 항목은 그대로 유지됩니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **노트** | Craft Note | 예 | 없음 | 업데이트할 문서입니다. |
    | **제목** | 텍스트 | 아니요 | 변경 안 함 | 새 제목입니다. 비워 두면 현재 제목이 유지됩니다. |
    | **첨부파일** | 파일 목록 | 아니요 | 변경 안 함 | 문서 끝에 추가되는 파일입니다. 기존 첨부파일은 유지됩니다. |
    | **즐겨찾기** | 부울 | 아니요 | 변경 안 함 | 켜면 문서를 즐겨찾기에 추가합니다. 끄면 즐겨찾기에서 제거합니다. |
    | **폴더** | Craft Note Folder | 아니요 | 변경 안 함 | 문서가 현재 속한 스페이스 안의 대상 폴더입니다. 폴더에서 빼려면 미분류를 선택하세요. |

    폴더 선택기에는 여러 스페이스의 폴더가 스페이스 이름과 폴더 이름으로 표시됩니다. 문서가 현재 속한 스페이스의 폴더를 선택하세요. 다른 스페이스의 폴더를 선택하면 「선택한 항목이 다른 공간에 속해 있습니다」 오류와 함께 동작이 실패합니다.

    폴더 이동에 실패하면 동작이 오류를 보고합니다. 이미 적용된 제목, 즐겨찾기, 첨부파일 변경 사항은 저장된 상태로 남습니다.

    문서에 텍스트를 추가하려면 Append Text to Note를 사용하세요.

    #### 반환값

    **Craft Note:** 업데이트된 문서입니다.
  </Accordion>

  <Accordion title="Append Text to Note" id="append-text-to-note">
    Craft 문서 끝에 텍스트를 추가합니다. 비어 있지 않은 각 줄은 별도의 블록이 됩니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **노트** | Craft Note | 예 | 없음 | 텍스트를 추가할 문서입니다. |
    | **콘텐츠** | 텍스트 | 예 | 없음 | 추가할 텍스트입니다. 빈 줄은 건너뜁니다. |

    #### 반환값

    **Craft Note:** 업데이트된 문서입니다.
  </Accordion>

  <Accordion title="알림 생성 (Siri 동작)" id="create-reminder-siri-actions">
    스페이스의 작업 Inbox에 Craft 작업을 만듭니다. 알림 카테고리의 알림 생성과는 다릅니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **제목** | 텍스트 | 예 | 없음 | 작업 텍스트입니다. |
    | **공간** | Craft Reminder List | 아니요 | 스페이스가 하나뿐이면 그 스페이스 | 대상 스페이스입니다. 스페이스가 둘 이상이면 Craft가 사용할 스페이스를 묻습니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 비어 있음 | 작업 안에 추가되는 텍스트입니다. |
    | **예약 날짜** | 날짜 | 아니요 | 없음 | 일정 날짜입니다. 마감일이나 알림은 설정하지 않습니다. |

    **섹션**은 비워 두세요. 설정하면 「섹션은 지원되지 않습니다」 오류와 함께 동작이 실패합니다. Apple의 형식에는 깃발 표시, 이미지, 태그, URL, 반복, 위치 트리거도 표시됩니다. Craft는 이 필드를 무시합니다. 이미지, 마감일 또는 알림이 필요하면 [작업 생성](#create-task)을 사용하세요.

    #### 반환값

    **Craft Reminder:** 새 작업입니다. 알림 열기, 알림 업데이트, 알림 삭제에 전달할 수 있습니다.
  </Accordion>

  <Accordion title="알림 열기" id="open-reminder">
    Craft 작업을 엽니다. Inbox의 작업은 Inbox에서 열리고, 다른 작업은 해당 문서에서 열립니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **리마인더** | Craft Reminder | 예 | 없음 | 열 작업입니다. |

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="알림 업데이트" id="update-reminder">
    Craft 작업을 업데이트합니다. 비워 둔 항목은 그대로 유지됩니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **리마인더** | Craft Reminder | 예 | 없음 | 업데이트할 작업입니다. |
    | **제목** | 텍스트 | 아니요 | 변경 안 함 | 새 작업 텍스트입니다. |
    | **콘텐츠** | 텍스트 | 아니요 | 변경 안 함 | 작업 안에 추가되는 텍스트입니다. 기존 내용은 유지됩니다. |
    | **예약 날짜** | 날짜 | 아니요 | 변경 안 함 | 새 일정 날짜입니다. 알림은 설정하지 않습니다. |
    | **완전한** | 부울 | 아니요 | 변경 안 함 | 켜면 작업을 완료합니다. 끄면 완료되지 않은 상태로 표시합니다. |
    | **공간** | Craft Reminder List | 아니요 | 비어 있음(작업을 현재 스페이스에 유지) | 설정하는 경우 작업이 현재 속한 스페이스여야 합니다. 다른 스페이스를 선택하면 「공간 간 작업 이동은 지원되지 않습니다」 오류와 함께 실패합니다. |

    제목, 콘텐츠, 예약 날짜를 비워 두면 현재 값이 유지되며 지워지지 않습니다. Apple의 형식에는 태그, URL, 반복, 깃발 표시, 위치 트리거도 표시됩니다. Craft는 이 필드를 무시합니다.

    #### 반환값

    **Craft Reminder:** 업데이트된 작업입니다.
  </Accordion>

  <Accordion title="알림 삭제" id="delete-reminders">
    하나 이상의 Craft 작업을 삭제합니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **알림** | Craft Reminder 목록 | 예 | 없음 | 삭제할 작업입니다. 서로 다른 스페이스에 있어도 됩니다. |

    #### 반환값

    없음.
  </Accordion>

  <Accordion title="문서 검색" id="search-documents">
    검색어로 Craft 검색을 엽니다.

    #### 매개변수

    | 매개변수 | 유형 | 필수 | 기본값 | 설명 |
    | - | - | - | - | - |
    | **검색** | 텍스트 | 예 | 없음 | 검색어입니다. |

    Craft에서 열려 있는 스페이스나 마지막으로 사용한 스페이스를 검색합니다. 결과는 Craft에서 열리며, 단축어로 문서 목록이 반환되지 않습니다. 스페이스를 선택하려면 [열기 및 검색](#open-and-search)을 사용하세요.

    #### 반환값

    없음.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.