Obsidian Tasks Plugin: How to Use It, Syntax and Queries
To use the Obsidian Tasks plugin, install it from Community plugins, then add fields to any checkbox: 📅 and a date for the due date, ⏫ for high priority, 🔁 every week to repeat it. A tasks code block containing a filter such as not done lists matching tasks from your whole vault. The cheat sheet below covers every field.
Use your Tasks syntax in TaskForge
- [ ] Task name
- [x] Completed task
- [ ] Task with due date 📅 2026-11-16
- [ ] High priority task ⏫
- [ ] Recurring task 🔁 every week
- [ ] Task with tags #work #important Why Choose TaskForge for Obsidian Tasks?
A native app for tasks, notes and calendar, built for Obsidian users who need mobile access
Tasks format support
Works with the Obsidian Tasks plugin format as-is. Your existing tasks, tags, dates, and metadata are fully supported.
Truly Cross-Platform
Native apps for iPhone, iPad, Mac, Windows and Android. TaskForge keeps its settings in your vault, so they travel with your vault sync.
Smart Notifications
Custom notification times, due date alerts and overdue reminders, delivered even when Obsidian is closed. Requires TaskForge Premium.
What Is the Obsidian Tasks Format?
In Obsidian, open Settings → Community plugins, browse for Tasks, then install and enable it. The Obsidian Tasks plugin reads the dates and priorities on your Markdown checkboxes; TaskForge reads the same files on your other devices after your vault syncs.
Every format's syntax: the task format cheat sheet
Basic Task Format
- [ ] Task name
- [x] Completed task
- [ ] Task with due date 📅 2026-11-16
- [ ] High priority task ⏫
- [ ] Recurring task 🔁 every week
- [ ] Task with tags #work #important Due Dates
Add due dates with the 📅 emoji followed by the date in YYYY-MM-DD format. With TaskForge Premium, you can get a reminder before the due date.
📅 2026-11-16 Scheduled, Start and Other Dates
Use ⏳ for the scheduled date (when you plan to work on it), 🛫 for the start date (the earliest day you can begin), ➕ for the created date, ✅ for the done date and ❌ for the cancelled date. Each takes a YYYY-MM-DD date.
- [ ] Draft the report ⏳ 2026-11-12 🛫 2026-11-10 📅 2026-11-16 Times in TaskForge
TaskForge uses ⏰ followed by a time for timed tasks. This is a TaskForge extension, not a scheduling field in the Obsidian Tasks plugin.
⏰ 14:30 Priorities
Use 🔺 for highest, ⏫ for high, 🔼 for medium, 🔽 for low and ⏬ for lowest priority. Leave out the symbol for normal priority.
- [ ] Send the project brief ⏫ Recurring Tasks
Create repeating tasks with 🔁 followed by recurrence rules like 'every day', 'every week', or 'every month'.
🔁 every week Tags
Organize tasks with hashtags. Use multiple tags to categorize tasks by project, context, or priority.
#work #urgent Subtasks
Create task hierarchies by indenting subtasks. TaskForge displays them in a clean, organized view.
- [ ] Subtask Dependencies and On Completion
Give a task an id with 🆔, then add ⛔ and that id to any task that waits on it. Queries can then show only unblocked work with is not blocked. 🏁 delete removes a task from the note when you complete it; on a recurring task, the next occurrence takes its place.
- [ ] Send the invoice ⛔ price1 Tasks filter examples
Paste a fenced tasks query into a note and switch to Reading view. Each line narrows the results: all filters must match. These queries use the Tasks plugin, not TaskForge Spaces (formerly custom lists).
Unfinished tasks due today
Show unfinished tasks with a due date of today. Tasks without a due date are excluded.
```tasks
not done
due today
``` Overdue work tasks
Show unfinished tasks tagged #work whose due dates are before today, sorted by due date.
```tasks
not done
tags include #work
due before today
sort by due
``` How Does TaskForge Enhance Mobile Task Management?
The Obsidian Tasks plugin runs inside Obsidian on desktop and mobile. TaskForge brings the same tasks to native apps for iPhone, iPad, Mac, Android and Windows, with widgets and reminders that work while Obsidian is closed.
Native Mobile Apps
Dedicated apps for iOS and Android with full offline support. Manage tasks anywhere, even without internet.
Smart Notifications
Get notified about upcoming tasks, due dates, and overdue items. Customize notification times for each task.
Interactive Widgets
Complete tasks directly from your home screen. Completions update the task in your local vault; other devices receive the change after your vault syncs.
Spaces and Filters
Build Spaces that filter by tags, dates, priorities and more, so each view shows what matters. Custom Spaces need TaskForge Premium.
Kanban & Calendar
Visualize tasks in Kanban boards or calendar views. Drag and drop to reorganize and plan your work.
Sync Through Your Own App
Changes appear on other devices after your vault syncs. Edit the same Markdown files in TaskForge or Obsidian.
Getting Started with TaskForge
- 1 Download TaskForge - Get the app for your device from the App Store or Google Play.
- 2 Connect Your Vault - Point TaskForge to your Obsidian vault location (iCloud, local, or other sync service). Use your existing vault sync service to make the same files available on each device. Changes appear elsewhere after that service syncs; on iOS, Obsidian Sync may require opening Obsidian.
- 3 Choose a Space - Spaces (formerly custom lists). Start with Today to see overdue tasks and tasks due today. With TaskForge Premium, edit a task section's filters for due date, priority or tags.
- 4 Enable Notifications - Configure notification settings to get reminders for due dates and custom times.
- 5 Add Widgets - Place TaskForge widgets on your home screen for quick access to your tasks.
What Are Common Workflows and Best Practices?
GTD (Getting Things Done) Workflow
Implement David Allen's GTD methodology with Obsidian tasks and TaskForge:
- Inbox: Create an 'Inbox' list to capture all tasks quickly. Use TaskForge's quick add feature to capture tasks on the go.
- Next Actions: Tag tasks with #next-action and create a Space to filter them. Focus on actionable items. Editing a task section's filters requires TaskForge Premium.
- Waiting For: Use #waiting tag for tasks blocked by others. Review regularly in TaskForge.
- Projects: Group related tasks with project tags like #project-website. Use subtasks for project steps.
- Someday/Maybe: Tag future ideas with #someday and review during weekly planning.
Daily Planning Routine
Start each day with a focused task review using TaskForge:
- Morning Review: Check TaskForge's 'Today' view to see all tasks due today. Use the calendar view to plan your day.
- Priority Setting: Add ⏫ to your top 3 tasks for the day. Create a 'Today Priority' Space filtered by high priority. Editing a task section's filters requires TaskForge Premium.
- Time Blocking: Add specific times (⏰) to tasks. With TaskForge Premium, you get a notification at those times.
- Evening Review: Check off completed tasks, reschedule unfinished items, and plan tomorrow.
Project Management
Manage complex projects with Obsidian tasks and TaskForge's advanced features:
- Project Notes: Create a note for each project with all related tasks. TaskForge scans all notes in your vault.
- Kanban View: Use TaskForge's Kanban board to visualize project stages: To Do, In Progress, Done.
- Milestones: Tag milestone tasks with #milestone and set due dates. Track progress in calendar view.
- Dependencies: Give a task an id with 🆔 and mark the tasks that wait on it with ⛔ and that id. The Tasks plugin can then filter blocked work, and TaskForge reads the same fields.
Frequently Asked Questions
Do I need the Obsidian Tasks plugin to use TaskForge?
Do I need the Obsidian Tasks plugin to use TaskForge?
No, you don't need the Obsidian Tasks plugin installed to use TaskForge. TaskForge connects directly to your Obsidian vault and reads and writes the same plain-Markdown task format the plugin uses, including the emoji metadata for due dates, priorities, and recurrence. That means you can run TaskForge as a complete standalone task manager, or keep using the Obsidian Tasks plugin on your desktop and let TaskForge handle the same tasks on mobile and in widgets. Because both work from the identical Markdown in your vault, there's no second copy of your data and nothing to keep in sync between them, a task you complete in one shows as complete in the other the next time your vault syncs. Most people who already use the plugin simply point TaskForge at the same vault and keep their existing setup.
Will TaskForge modify my Obsidian notes?
Will TaskForge modify my Obsidian notes?
TaskForge only ever changes the task lines you act on, when you complete, edit, create, or reschedule a task, and it writes those changes using the standard Obsidian Tasks Markdown format. Everything else in your note (headings, paragraphs, links, frontmatter, other list items) is left exactly as it was. There's no proprietary database and no hidden metadata file: your tasks live as plain text inside the same notes you already keep, so the result is fully readable and editable back in Obsidian. Because the edits are in the standard format, the Obsidian Tasks plugin recognizes them immediately, and your version history (Git, Obsidian Sync, or any backup) keeps working normally. If you ever stop using TaskForge, your tasks simply remain as ordinary Markdown checkboxes in your vault.
Can I use TaskForge with multiple vaults?
Can I use TaskForge with multiple vaults?
Not with in-app vault switching yet, though it's planned. TaskForge reads one vault directory at a time, so there's no built-in switcher for hopping between separate vaults. The workaround most people use works on phone and desktop alike: keep your vaults inside one shared parent folder, then set that parent folder as the TaskForge vault directory. With Premium, make a Space per vault, give each Space a File Path filter that matches that vault's subfolder so it only shows those tasks, and set the Space's default location so new tasks save into the right vault. One setup then covers several vaults with their tasks kept apart. On iPhone and iPad you choose that parent folder through the system file picker, so it can sit anywhere in iCloud Drive, however deep it's nested. Real multi-vault support, where each vault keeps its own tasks, Spaces, filters and preferences, is on the roadmap for a later release.
How does sync work across devices?
How does sync work across devices?
TaskForge doesn't run its own task cloud. It reads and writes the Markdown files in your Obsidian vault, so it syncs across devices with whatever you already trust for that vault: iCloud Drive, Obsidian Sync, Syncthing, Dropbox or a Git-based workflow. Whatever one device writes to the vault, the others pick up the next time your sync runs, exactly like your notes. Your task data stays in one place, your vault, with no separate account and no second copy that could drift. TaskForge also keeps its own settings and Spaces in a folder inside the vault, so they travel with the same sync; on Apple devices, some preferences also sync through iCloud.
What's the difference between TaskForge and Obsidian mobile app?
What's the difference between TaskForge and Obsidian mobile app?
The Obsidian mobile app is built for reading and editing notes, and while you can tick a checkbox in it, it has no dedicated task interface. TaskForge is purpose-built for task management on top of the same vault: it adds smart notifications and due-date reminders that fire even when Obsidian is closed, interactive home screen widgets, Kanban boards, calendar views, and advanced filtering and Spaces. It also brings quick capture so you can add a task in seconds without opening your vault. The two are complementary rather than competing, many people keep Obsidian mobile for writing and reference and use TaskForge for everything task-related, both pointed at the same files. If your main need on the phone is acting on tasks rather than editing prose, TaskForge is the faster, more focused tool.
Can I create tasks in specific notes?
Can I create tasks in specific notes?
Yes. When you create a task in TaskForge you can choose exactly which note it lands in, so a task can live in the project note, daily note or area file where it belongs rather than in one giant list. A Space can also carry a default note, so anything you add inside, say, your Work or Errands Space is filed in the right place without picking each time. This keeps your vault organized the way you already think about it, by project or area of responsibility. Combined with Spaces and contexts, it lets TaskForge match an existing Obsidian structure closely, so the tasks you create on mobile end up in the same notes you'd have chosen on the desktop.
Use your Tasks syntax in TaskForge
TaskForge reads your existing Obsidian Tasks format on iPhone, iPad, Mac, Android and Windows. Manage tasks and notes, with widgets, reminders and your calendar beside them.
Related Articles
- Complete GTD Guide for Obsidian Implement the Getting Things Done methodology in Obsidian with TaskForge's powerful task management. Read more
- Mastering Recurring Tasks in Obsidian Learn how to set up and manage recurring tasks with flexible patterns and automatic regeneration. Read more
- Obsidian Todo List Guide Set up Obsidian as your todo list with tasks, priorities, due dates, and mobile widgets. Read more
- Best Obsidian Task Plugins & Apps Compare the best Obsidian task management plugins and apps to find the right solution for your workflow. Read more
- Obsidian Tasks Plugin App: Widgets, Kanban & Reminders See how TaskForge takes the Obsidian Tasks plugin format to native iPhone, iPad, Mac, and Android apps, with home screen widgets, reminders, and kanban boards. Read more
- Obsidian Project Management: Tasks, Kanban & Reminders Run projects in Obsidian: project notes, Tasks queries, a Bases dashboard and kanban. Then add what Obsidian lacks: phone reminders and widgets. Read more
- TaskNotes on your home screen See tasks in a widget and check them off where you are. Reminders bring dated tasks back to your attention. Both use the TaskNotes in your vault. Read more
- How to Convert Obsidian Tasks Between Formats Move Obsidian tasks between emoji, Dataview fields and task files. Tested scripts, find and replace recipes, before and after examples, and what gets lost. Read more
- How to Set Up a Kanban Board in Obsidian A plain guide to kanban for Obsidian tasks: what the columns really are, how the markdown underneath changes when you drag a card, and how to set up a board. Read more