Obsidianタスク書式チートシート

タスク行の構造

タスクとは、チェックボックス付きのリスト項目です。説明文の後ろにフィールドが続き、各フィールドは記号と値の組になります。Obsidian Tasksは行を右から読むため、フィールドはテキストの後ろの行末に置きます。認識できないテキストが2つのフィールドの間にあると、そこで読み取りが止まります。

同じタスクを、インライン書式ごとに並べます。

- [ ] Pay rent ⏫ 🔁 every month ➕ 2026-01-02 ⏳ 2026-01-14 📅 2026-01-15

- [ ] Pay rent  [priority:: high]  [repeat:: every month]  [created:: 2026-01-02]  [scheduled:: 2026-01-14]  [due:: 2026-01-15]

- [ ] Pay rent #project/Home @bank ⏫ 📅 2026-01-15 09:00 [repeat:: every month]

フィールドを並べて比較

日付は常にYYYY-MM-DD形式です。Dataview列は角括弧を使います。Obsidian TasksとDataviewは丸括弧 (due:: 2026-01-15) も読みますが、Task Geniusが読むのは角括弧だけです。Task Geniusは絵文字と角括弧の両方を読むので、その列には追加分と表記が異なる分だけを載せています。

幅が狭い画面では横にスクロールしてください。

Obsidian Tasksがフィールドを書く順序

Obsidian Tasksが行を書くときは、まずID、依存先、優先度、繰り返し、完了時の動作を置き、次に作成日、開始日、予定日、期限日、最後にキャンセル日と完了日を置きます。手書きで順序が違っても、すべてのフィールドが行末にあれば読み取れます。

ステータス文字

角括弧の中の文字がステータスです。どこでも通用するのはスペースと x だけです。それ以外は慣習であり、プラグイン、テーマ、ステータスコレクションが意味を与えています。

Obsidian Tasksでは、設定していない文字は「Unknown」ステータスとして表示されます。プラグインのCustom Statuses設定で追加するか、用意済みのステータスコレクションを読み込んでください。

Task Geniusが完了と見なすのは x と X だけです。TaskNotesのファイルはチェックボックスの文字をまったく使わず、status プロパティを持ちます。詳しくは後述します。

繰り返し

繰り返しは、書式ごとの違いが最も大きい部分です。同じ毎週のタスクを4通りで書くと次のとおりです。

- [ ] Water plants 🔁 every week on Sunday when done 📅 2026-01-18

- [ ] Water plants  [repeat:: every week on Sunday when done]  [due:: 2026-01-18]

- [ ] Water plants [recurrence:: FREQ=WEEKLY;BYDAY=SU] [due:: 2026-01-18]

recurrence: "DTSTART:20260118;FREQ=WEEKLY;BYDAY=SU"
recurrence_anchor: completion

Obsidian Tasksが解釈するルール

ルールはすべて every で始まります。元の日付ではなく、完了した日から数えたいときは when done を付けます。

every 3 days
every 10 days when done
every weekday
every week on Sunday
every week on Tuesday, Friday
every 2 weeks
every 3 weeks on Friday
every 2 months
every month on the 1st
every month on the last
every month on the last Friday
every month on the 2nd last Friday
every January on the 15th
every April and December on the 1st and 24th
every year

完了時の動作

• Obsidian Tasks：繰り返しタスクにチェックを入れると、その行が完了になり、日付を進めた新しい行が追加されます。既定では元の行の上で、設定により下にもできます。
• Obsidian Tasks：繰り返しタスクには、期限日、予定日、開始日のうち少なくとも1つが必要です。なければ、ルールが動かす日付がありません。
• Obsidian Tasks：月次ルールで存在しない日付（4月31日）になる場合は、その月の最終日に前倒しされます。31日を明示したルールは、31日がない月を飛ばします。
• Obsidian Tasks：新しい行にはIDと依存先フィールドが引き継がれないため、依存関係が永遠に解消されないことはありません。
• TaskNotes：ファイルは1つのタスクのままです。完了した日付とスキップした日付は complete_instances と skipped_instances に入り、スケジュールが進みます。
• Task Genius：次の日付は、iCalendarのルールか every 2 weeks のような簡単な語句から求めます。every weekday や the last Friday of the month のようなObsidian Tasksの凝った語句は同じようには読まれないので、頼る前にいくつか試してください。
• 繰り返しタスクはデイリーノートに置かないでください。デイリーノート内の繰り返し行は、毎日のノートにコピーされます。

タスクファイル：TaskNotesのフロントマター

TaskNotesは1ノートにつき1タスクを保存します。内容はYAMLフロントマターに入り、本文は自由なテキストです。プラグイン設定で決めたタグまたはプロパティ（既定は task タグ）を持つファイルが、タスクとして扱われます。

---
tags:
  - task
title: Review quarterly report
status: in-progress
priority: high
due: 2026-01-15
scheduled: 2026-01-14
contexts:
  - office
projects:
  - "[[Q1 Planning]]"
timeEstimate: 90
recurrence: "DTSTART:20260115;FREQ=MONTHLY;BYMONTHDAY=15"
recurrence_anchor: scheduled
---

Notes, links and a checklist go in the body.

プロパティ

title: Review quarterly report

status: in-progress

priority: high

due: 2026-01-15

scheduled: 2026-01-14T09:00

completedDate: 2026-01-15

dateCreated: 2026-01-02T08:00:00Z

dateModified: 2026-01-15T10:30:00Z

tags: [task, finance]

contexts: [office]

projects: ["[[Q1 Planning]]"]

timeEstimate: 90

recurrence: "FREQ=WEEKLY;BYDAY=MO,WE,FR"

recurrence_anchor: completion

complete_instances: ["2026-01-08"]

skipped_instances: ["2026-01-22"]

- uid: "Tasks/Draft report.md"
  reltype: FINISHTOSTART

プロパティ名は設定で変えられます。プラグインで due を deadline に変えたなら、ファイルでも deadline を使う必要があります。

項目が1つでも、リストはリストとして書く必要があります。リストの場所にスカラー値を書くのは、タスクファイルがビューに表示されない原因として最も多いものです。

一晩を無駄にしかねないつまずきポイント

• Obsidian Tasksが読み書きできる書式は、同時に1つだけです。設定がDataviewだと、元に戻すまで同プラグイン自身の絵文字は読まれません。
• Dataviewではコロンを2つ重ねます。[due:: 2026-01-15] が正しく、コロン1つではフィールドになりません。
• 括弧の種類は揃える必要があります。[due:: 2026-01-15) は読まれません。
• Dataview形式でのObsidian Tasksのキーは大文字小文字を区別します。repeat、dependsOn、onCompletion は動きますが、Repeat や dependson は動きません。Task Geniusは大文字小文字を区別せずにキーを照合します。
• 完了日のキーは completion です。[done:: 2026-01-15] は、ただの未知のフィールドです。
• Dataviewは期限の省略記法として 🗓️ を文書化していますが、Obsidian Tasksは 📅 を書きます。絵文字の日付をDataviewで検索するなら、先に自分のバージョンで試してください。角括弧のフィールドなら、この問題を避けられます。
• 貼り付けたテキストに、ノーブレークスペースや絵文字の後ろの異体字セレクタが紛れ込むことがあります。Obsidian Tasksはそれを読めず、画面上では行が正常に見えます。
• Dataviewの省略記法があるのは5つの日付だけです。優先度と繰り返しには省略記法がなく、角括弧形式が必要です。
• Obsidian Tasksの #task のようなグローバルフィルターを設定すると、そのタグのないチェックボックスはすべて無視されます。クエリからタスクが消えたときは、これが原因のことが多いです。
• フェンス付きコードブロック内のチェックボックス行は、どのプラグインでもタスクになりません。

一次情報

プラグインは変わります。ここに書かれた内容がお使いのバージョンと合わないときは、このページよりも次の文書を信頼してください。

• Obsidian Tasks：Tasks Emoji Format
• Obsidian Tasks: Dataview Format
• Obsidian Tasks：Recurring Tasks
• Obsidian Tasks: Statuses
• Dataview: Metadata on Tasks and Lists
• Dataview: Adding Metadata (inline fields)
• Task Geniusのドキュメント
• GitHubのTask Genius
• TaskNotesのドキュメント
• TaskNotes: Property Types Reference

よくある質問