docs: update docs for add task options

Author: jamiebrynes7

docs/docs/changelog.md

@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Task deadlines are now displayed in the task metadata with a target icon, and can be toggled using `deadline` in the `show` query property.
 - You can now set a deadline when creating tasks from the task creation modal. This option only appears for premium Todoist users.
+- You can now automatically copy a markdown link to newly created tasks, with options for either app URI or web URL format.
 
 ## v2.2.1 (2025-09-22)
 

docs/docs/commands/add-task.md

@@ -13,3 +13,15 @@ There are a few variants of the command:
 - 'Add task', the basic version
 - 'Add task with current page in task content', this option will append a link to the current page in the task content before it sends it to Obsidian. The modal will inform you it will do this, but the link is not shown to keep the modal clean.
 - 'Add task with current page in task description', this option will append a link to the current page in the task description before it sends it to Obsidian. The modal will inform you it will do this, but the link is not shown to keep the modal clean.
+
+## Copy markdown link after creating task
+
+The 'Add task' button in the modal is a split button with a dropdown menu. You can click the dropdown arrow to choose between three actions:
+
+- **Add task** - Creates the task without copying anything
+- **Add task and copy link (app)** - Creates the task and copies a markdown link with an app URI (`todoist://task?id=...`)
+- **Add task and copy link (web)** - Creates the task and copies a markdown link with a web URL (`https://todoist.com/app/project/...`)
+
+The markdown link format is `[task content](url)`, which you can paste directly into your Obsidian notes. The link will open the task in Todoist when clicked.
+
+You can set your preferred default action in the plugin settings under "Task creation" → "Default add task action".

docs/docs/configuration.md

@@ -69,6 +69,16 @@ This defines the default labels assigned to tasks created via [commands](./comma
 
 If any of the selected labels no longer exist in Todoist, you will get a warning when opening the task creation modal and they will be skipped.
 
+### Default add task action
+
+This setting controls the default action for the 'Add task' button in the task creation modal. You can choose between:
+
+- **Add task** - Creates the task without copying a link
+- **Add task and copy link (app)** - Creates the task and copies a markdown-formatted link using the Todoist app URI
+- **Add task and copy link (web)** - Creates the task and copies a markdown-formatted link using the Todoist web URL
+
+This sets the initial button action when opening the modal, but you can change it per-task using the split button dropdown. See the [Add task command documentation](./commands/add-task#copy-markdown-link-after-creating-task) for more details.
+
 ## Advanced
 
 ### Debug logging