KosshiKosshi

1.21 Beta のガイドです。公開中の版は 1.20です。

検索リファレンス

検索で使える条件の一覧です。基本的な検索の組み立て方は、検索ガイドをご覧ください。

検索対象を限定する

in: を使うと、行のどの部分を通常のテキスト検索の対象にするかを限定できます。

検索式検索するもの
in:note projectノートだけ
level:2階層レベル 2 の行。最上位は 0
sort:date日付の古い順
sort:date-desc日付の新しい順

in:note は検索語を照合する場所だけを変えます。単独では行を絞り込まないため、in:note project のように検索語と組み合わせます。ノートのある行を探すときは has:note を使います。

状態・添付・リンク

プレフィックス値と例一致するもの
is:complete、incomplete、bookmarked、unbookmarked行の状態
has:image、sketch、file、attachment指定した添付がある行
has:tag、#、@指定した種類のタグがある行
has:link、note、dateリンク、ノート、日付付きタグがある行
backlinks:backlinks: の後に候補から行を選ぶ指定した行を参照している行

バックリンクの条件は、バックリンクがある行の右側に表示される件数をクリックすると、簡単に検索できます。backlinks: まで入力すると候補一覧が表示され、そこから対象の行を選ぶこともできます。画面の流れは内部リンクで説明しています。

条件を除外する

語や条件の直前に - を付けると、それに一致しない行を検索できます。括弧でまとめた条件を除外するときは NOT を使います。

検索式一致するもの
-has:image画像がない行
-is:complete完了していない行
-tag:work#work も @work もない行
is:bookmarked -has:imageブックマーク済みで画像がない行
NOT (bug OR crash)bug も crash も含まない行

- で始まる文字列そのものを検索するときは、"-foo" のように引用符で囲みます。

タグとタグの値

通常のタグ検索では、# または @ を付けて指定します。tag: を使ってタグの種類を限定することもできます。行に入力する値付き @タグ は括弧を使い、検索欄では値の前に : を付けます。タグ名と値が一致する行が対象になり、大文字・小文字は区別しません。値に空白を含む場合は、@todo(every monday) のように括弧形式を使います。

検索式一致するもの
#work#work とその下位パス
@work@work
tag:work#work または @work
tag:#work#work とその下位パス
tag:@work@work
@status:done@status(done)
@todo(every monday)@todo(every monday)

: の後の値が日付や数値としても読める場合は、その両方に一致します。たとえば @label:today は、@label(today) と、今日の日付を持つ @label の両方に一致します。文字列だけに一致させるときは、@label:"today" のように引用符で囲みます。

特定の @タグ の数値は、一致する値または範囲で検索できます。

検索式一致するもの
@estimate:3@estimate(3)
@estimate:>=33 以上
@estimate:<33 未満
@estimate:3..83 から 8 まで。両端を含む

日付

日付検索には 3 種類あります。created: と modified: は行の作成日・更新日、date: は日付付き @タグ 全体、@kind: は指定した @タグ の種類だけを検索します。たとえば @deadline: は @deadline の日付を検索します。

特定の @deadline だけを検索するときは @deadline:today を使います。タグ名に関係なく、日付付きタグを横断して今日のものを検索するときは date:today を使います。

検索式一致するもの
created:today今日作成した行
created:7d今日を含む直近 7 日間に作成した行
modified:30d今日を含む直近 30 日間に更新した行
created:this-week今週作成した行
created:last-month先月作成した行
created:2026-04-15指定日に作成した行
modified:today今日更新した行
date:today今日の日付を持つ @タグ がある行
date:next-week来週の日付を持つ @タグ がある行
@deadline:tomorrow@deadline が明日の日付の行
has:date日付付き @タグ がある行

相対日付に使える値は次のとおりです。

検索式使える値
created:、modified:today、yesterday、Nd(例: 1d、7d)、this-week、last-week、this-month、last-month、this-year、last-year
date:、@kind:today、tomorrow、yesterday、last-week、this-week、next-week、last-month、this-month、next-month、last-year、this-year、next-year

週は月曜始まりです。7d は今日を含む直近 7 日間、last-week はカレンダー上の先週を表します。

日付の入力形式は日付入力で設定できます。ISO 形式の完全な日付は常に使えます。

>、<、>=、<= を付けると、指定日より前後の日付を検索できます。>= と <= は指定日を含み、> と < は指定日を含みません。created: と modified: では、today、yesterday、特定の日付と比較できます。

作成日・更新日の検索には、created-after:、created-before:、modified-after:、modified-before: も使えます。-after: は指定日を含み、-before: は指定日を含みません。値には today や 2026-04-01 のような単一の日付を指定します。

検索式一致するもの
created-after:2026-04-012026 年 4 月 1 日以降に作成した行
created-before:2026-04-302026 年 4 月 30 日より前に作成した行
modified-after:2026-04-012026 年 4 月 1 日以降に更新した行
modified-before:2026-04-302026 年 4 月 30 日より前に更新した行
検索式一致するもの
created:>=2026-04-012026 年 4 月 1 日以降に作成した行
modified:<today昨日までに最後に更新した行
date:<today今日より前の日付を持つ @タグ がある行。期限切れの項目など
date:<=today今日以前。今日を含む
date:>today今日より後
@deadline:>=2026-09-102026 年 9 月 10 日以降。指定日を含む
@deadline:<2026-09-102026 年 9 月 10 日より前

.. で範囲を指定できます。範囲の両端を含みます。

検索式一致するもの
date:2026-09-10..2026-09-209 月 10 日から 9 月 20 日までの @タグ
@deadline:2026-09-10..2026-09-20その範囲にある @deadline
date:9/10..9/20選択した年なし日付の順序で解釈される日付