Skip to main content
Guides

Obsidian Tasks Plugin: Complete How-To Guide

Master Obsidian tasks with TaskForge - the most powerful cross-platform task manager designed specifically for Obsidian users. Full compatibility with Obsidian Tasks plugin format.

TaskForge main task view on macOS showing comprehensive task management
View All Features

Why Choose TaskForge for Obsidian Tasks?

The only task manager built specifically for Obsidian users who need mobile access

100% Compatible

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, and Android. Settings sync across all devices via iCloud.

Smart Notifications

Custom notification times, due date alerts, and overdue reminders. Never miss an important task.

What Is the Obsidian Tasks Format?

Obsidian tasks use a simple markdown checkbox syntax that's both human-readable and expressive. TaskForge fully supports the Obsidian Tasks plugin format, allowing you to manage your tasks across desktop and mobile devices.

Basic Task Format

- [ ] Task name
- [x] Completed task
- [ ] Task with due date 📅 2025-11-15
- [ ] High priority task ⏫
- [ ] Task with time ⏰ 14:30
- [ ] 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. TaskForge will send you notifications as the due date approaches.

📅 2025-11-15

Times

Specify exact times for tasks using the ⏰ emoji. Perfect for appointments and time-sensitive tasks.

⏰ 14:30

Priorities

Set task priorities using emoji indicators: ⏫ (highest), 🔼 (high), 🔽 (low), ⏬ (lowest).

⏫ ⏬

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

How Does TaskForge Enhance Mobile Task Management?

While Obsidian Tasks plugin works great on desktop, TaskForge brings your tasks to mobile with native apps for iPhone, iPad, Mac, and Android. Get the full power of Obsidian task management in your pocket.

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. Widgets update in real-time and sync instantly to your vault.

Advanced Filtering

Create custom lists with AND/OR logic. Filter by tags, dates, priorities, and more to focus on what matters.

Kanban & Calendar

Visualize tasks in Kanban boards or calendar views. Drag and drop to reorganize and plan your work.

Automatic Sync

Changes sync instantly across all devices. Edit in TaskForge or Obsidian - everything stays in sync.

Getting Started with TaskForge

  1. 1
    Download TaskForge - Get the app for your device from the App Store or Google Play.
  2. 2
    Connect Your Vault - Point TaskForge to your Obsidian vault location (iCloud, local, or other sync service).
  3. 3
    Create Smart Lists - Set up custom lists with filters to organize your tasks by project, priority, or context.
  4. 4
    Enable Notifications - Configure notification settings to get reminders for due dates and custom times.
  5. 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 Smart List to filter them. Focus on actionable items.
  • 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' Smart List filtered by high priority.
  • Time Blocking: Add specific times (⏰) to tasks. TaskForge will send notifications 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: Use subtasks to show task dependencies. Complete parent tasks only after subtasks are done.

Frequently Asked Questions

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?

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?

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. Make a custom list per vault, give each list a File Path filter that matches that vault's subfolder so it only shows those tasks, and set the list'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, lists, filters, and preferences, is on the roadmap for a later release.

How does sync work across devices?

TaskForge doesn't run its own task cloud, it reads and writes directly to the Markdown files in your Obsidian vault, so it syncs across devices using whatever solution you already trust for that vault: iCloud Drive, Obsidian Sync, Syncthing, Dropbox, or a Git-based workflow. Whatever changes one device writes to the vault, the others pick up the next time your sync runs, exactly like your notes do. This keeps your task data in one place, your vault, with no separate account to manage and no second source of truth that could drift out of sync. On top of the vault files, TaskForge also syncs its own app settings, such as your custom lists and preferences, via iCloud, so your setup follows you between your own Apple devices without having to be rebuilt on each one.

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 and Lock Screen widgets, Kanban boards, calendar views, and advanced filtering and Smart Lists. 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?

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. You can also set a default note for a specific list, so anything you add to, say, your Work or Errands list is automatically filed in the right place without you having to pick each time. This keeps your vault organized the way you already think about it, by project or area of responsibility, instead of dumping every task into a single inbox file. Combined with custom lists 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.

Ready to Master Obsidian Tasks?

Join thousands of Obsidian users managing their tasks with TaskForge. Discover all TaskForge features or visit our help center to get started.

Azhar Dewji
Azhar Dewji · · Updated November 3, 2025

Software engineer with 10+ years of experience building mobile and desktop apps in Swift, Kotlin, and Flutter. Indie developer based in Toronto, Canada. Creator of TaskForge. Learn more