Create deep links that open a specific task directly in Project Planner from anywhere in your Obsidian vault. URI links let you reference tasks in meeting notes, daily journals, documentation, and more.

Overview

Project Planner registers a custom Obsidian URI handler so you can link to any task by its unique ID. Clicking the link opens the plugin, switches to the correct project, and highlights the task instantly.

How It Works

URI Format

Every task link follows this structure:

obsidian://open-planner-task?id=TASK_ID&project=PROJECT_ID
  • id — the UUID of the target task
  • project — the UUID of the project containing the task

Copy Link to Task

Right-click any task row in Grid, Board, or Gantt view and select Copy link to task. The URI is copied to your clipboard immediately.

Alternatively, open the Open Markdown task note option from the same context menu to jump directly to the task's synced Markdown file.

Example Usage

Reference a task directly inside meeting notes:

## Sprint Planning — 2026-02-13

### Action Items
- Assign [Design landing page](obsidian://open-planner-task?id=f8e7d6c5-b4a3-2190-fedc-ba0987654321&project=a1b2c3d4-e5f6-7890-abcd-ef1234567890) to Sarah
- Review dependencies for [API integration](obsidian://open-planner-task?id=11223344-5566-7788-99aa-bbccddeeff00&project=a1b2c3d4-e5f6-7890-abcd-ef1234567890)
- Discuss timeline for the launch milestone

Task Notes

When Markdown Sync is enabled, each task has a corresponding .md file stored at {projectsBasePath}/{Project Name}/Tasks/{TaskTitle}.md. The file contains YAML frontmatter with the task's id, which you can use to manually construct a URI link:

---
id: f8e7d6c5-b4a3-2190-fedc-ba0987654321
title: Design landing page
status: In Progress
completed: false
---

Design the new landing page layout.

---
*Task from Project: My Project*

To generate notes for all tasks in the active project, use the Create Notes button in Settings → Actions.

Benefits

  • Seamless integration: Link tasks directly from any Markdown file in your vault without leaving Obsidian.
  • Instant context switching: Click a link to jump straight to the task — no searching or navigating required.
  • Meeting notes: Reference action items in meeting notes so they are always one click away from the full task details.
  • Daily notes: Embed links to tasks you plan to work on today for quick access.
  • Documentation: Link to implementation tasks from technical design documents or project roadmaps.

Tips

Tip

Use standard Markdown link syntax for cleaner display: [Task Title](obsidian://open-planner-task?id=...&project=...). In reading mode, only the task title is shown.

  • Quick access: Pin frequently referenced tasks by adding their links to a "Dashboard" note at the top of your vault.
  • Bi-directional navigation: Combine URI links with Markdown Sync so you can navigate from a note to the plugin and from the plugin back to the task's Markdown file.

Commands

The following actions generate or use URI links:

  • Copy link to task — Right-click any task in Grid, Board, or Gantt view. Copies the full URI to your clipboard with a confirmation notice.
  • Create Notes — Available in Settings → Actions. Creates or updates individual Markdown files for every task in the active project, each containing the task id in its YAML frontmatter.

Technical Details

Obsidian Protocol Handler

Project Planner registers the open-planner-task action with Obsidian's registerObsidianProtocolHandler API. When a URI is opened, the handler parses the id and project query parameters and navigates to the task.

UUID Task IDs

Task IDs are RFC 4122 v4 UUIDs, ensuring global uniqueness. Links remain valid as long as the task exists in its project's task file, regardless of whether the task title or project name changes.

Cross-Vault Links

Obsidian URIs are vault-scoped by default. To link to a task in a different vault, include the vault parameter:

obsidian://open-planner-task?vault=MyOtherVault&id=TASK_ID&project=PROJECT_ID

Automatic Project Switching

If the linked task belongs to a different project than the one currently open in the plugin, Project Planner automatically switches to the correct project before highlighting the task.

Important

If a task has been deleted, clicking its URI link will show a "Task not found" notice. The link itself remains in your note and can be removed manually.

Related Documentation