> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pensiv.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 검색 문법

> 검색창에서 쓰는 필드 조건과 빼기, 따옴표, OR입니다. 원고가 두꺼워질수록 한 줄로 범위를 미리 좁히는 편이 빠릅니다.

검색창은 Cmd(Ctrl)+K로 엽니다. 문법을 섞으면 훑을 자리를 미리 잘라 둡니다.

## 필드로 조건 걸기

`필드:값` 꼴로 붙여 씁니다. 콜론 앞뒤에 공백이 있으면 조건으로 읽히지 않습니다.

| 필드                | 하는 일          | 예                    |
| ----------------- | ------------- | -------------------- |
| `type:` `entity:` | 한 종류만 남깁니다    | `type:sheet`         |
| `category:`       | 시트 분류로 거릅니다   | `category:character` |
| `tag:`            | 태그로 거릅니다      | `tag:복선`             |
| `title:` `name:`  | 제목에 든 말로 거릅니다 | `title:1장`           |

`type:` 값은 document, sheet, folder, plotboard, canvas, plotcard, partcard, note, memo, task, label, status입니다. `category:`는 character, event, organization, item, location, worldbuilding, other입니다. 화면의 캐릭터·이벤트·조직·아이템·장소·세계관·기타에 맞습니다.

분류는 시트에만 붙어서 `category:`를 걸면 문서와 폴더가 빠집니다. 태그는 시트 속성과 노트, 플롯 파트 카드에 있습니다. 값에 띄어쓰기가 있으면 필드로 걸 수 없습니다.

## 빼기

조건 앞에 `-`를 붙이면 그 항목을 걷어냅니다. `-category:organization`은 조직 시트를, `-tag:초고`는 그 태그가 달린 것을 뺍니다. `category`·`tag`·`title`·`name`에만 듣습니다.

## 따옴표

`"검을 든 소녀"`처럼 감싸면 그 순서 그대로 붙어 있는 자리만 찾습니다. 감싸지 않으면 두 낱말이 어디에 흩어져 있어도 걸립니다.

## OR

`늑대 OR 이리`처럼 사이에 넣으면 둘 중 하나만 맞아도 남습니다. `or`도 됩니다. OR는 검색어만 가르고 필드 조건은 양쪽에 걸립니다. `category:character 늑대 OR 이리`는 캐릭터 시트 안에서만 두 낱말을 찾습니다. `category`·`tag`·`type`처럼 거르기만 하는 필드끼리 OR로 이으면 아무것도 남지 않습니다. `title`·`name`은 값 자체가 검색어라 `title:1장 OR title:2장`처럼 두 갈래로 찾습니다.

<div className="app-window block dark:hidden">
  <img src="https://mintcdn.com/raumlabsinc/lu6k4uiTwZ-0sk-g/images/ko/reference/search-syntax--01.png?fit=max&auto=format&n=lu6k4uiTwZ-0sk-g&q=85&s=dc7849d5333c252af05d18723e62b8d5" alt="검색 창을 열고 입력란에 `category:character 늑대`를 친 뒤 결과가 도착한 상태. 결과에 시트만 남고 문서·폴더가 섞이지 않은 화면이어야 한다." width="2880" height="1800" data-path="images/ko/reference/search-syntax--01.png" />
</div>

<div className="app-window hidden dark:block">
  <img src="https://mintcdn.com/raumlabsinc/lu6k4uiTwZ-0sk-g/images/ko/reference/search-syntax--01-dark.png?fit=max&auto=format&n=lu6k4uiTwZ-0sk-g&q=85&s=5d6f20ec32cca23ea2b0bf8b0a904c1e" alt="검색 창을 열고 입력란에 `category:character 늑대`를 친 뒤 결과가 도착한 상태. 결과에 시트만 남고 문서·폴더가 섞이지 않은 화면이어야 한다." width="2880" height="1800" data-path="images/ko/reference/search-syntax--01-dark.png" />
</div>

<p className="app-caption">필드 조건을 걸면 그 종류만 남습니다.</p>

<Note>
  지원하지 않는 필드 이름은 그냥 무시됩니다. 결과가 유난히 넓다면 철자부터 확인하세요.
</Note>
