# Complete Features of Todoist Context Bridge ```mermaid mindmap root["🌉 Obsidian Todoist Context Bridge"] ("🎯 Selective Highlighting") ("Choose important tasks") ("Prevent task overload") ("Focus on what matters") ("🔄 Context Preservation") ("Bidirectional links") ("Rich note context") ("Easy navigation") ("🔒 System Reliability") ("Redundant storage") ("Conflict prevention") ("Data integrity") ("📋 Task Review") ("Context-aware completion") ("Original note access") ("Better task understanding") ``` ## Dataview and Tasks Integration **Todoist Context Bridge** integrates with [[Dataview Integration for Todoist Context Bridge|Dataview]] and [[Tasks Plugin Integration for Todoist Context Bridge|Tasks]] plugins. ## Flexible Date Handling The plugin offers powerful and flexible date handling with multiple format options and smart features: ### Dataview Integration - Uses Dataview format by default: `[due::2024-01-01]` - Customizable key in settings (e.g., "deadline", "duedate") - Requirements: - Valid Dataview inline field names - Date format: YYYY-MM-DD - Optional time format: THH:mm ### Due Date Formats - **Standard Formats** - Date only: `[due::YYYY-MM-DD]` - Date and time: `[due::YYYY-MM-DDTHH:mm]` - Examples with custom keys: `[deadline::2024-01-01]`, `[duedate::2024-01-01T09:00]` - **Relative Dates** - Simple format: `1d` (tomorrow), `0d` (today) - Optional plus sign: `+1d` (tomorrow) - Supports any number of days: `20d`, `30d`, etc. - **Weekend Handling** - Context-aware weekend skipping - Optional per-task weekend skipping - Ideal for work vs personal tasks - Example: `5d` with weekend skipping will skip Saturday and Sunday - **[[Moment.js Format]] Support** - Custom date formats using Moment.js patterns - Configurable through settings - Example: `[📅 ]YYYY-MM-DD` matches `📅 2024-01-01` ### Date Processing Features - **Smart Date Validation** - Validates all date formats before processing - Clear error messages for invalid dates - Past date warnings (configurable) - **Contextual Weekend Skipping** - Choose to skip weekends per task - Visible only for relative dates - Recommended for work-related tasks - Maintains work-life balance - **Flexible Processing** - Multiple date format support - Graceful fallback between formats - Preserves time information when provided - **User Experience** - Clear date format hints in task modal - Intuitive weekend skip toggle - Past date confirmation dialog - Date validation feedback ## Priority Format and Mapping The plugin offers flexible priority mapping through Dataview format. You can customize both the priority key and the values that map to each priority level: 1. **Priority Key Customization** - Default key is `p` (e.g., `[p::1]`) - Customize in settings (e.g., `priority`, `pr`) - Must be a valid Dataview inline field name - Examples: `[p::high]`, `[priority::p1]` 2. **Value Mapping** - Map multiple values to each Todoist priority level - Supports both numeric and text values - Examples for Priority 1 (Highest): - Numeric: `[p::1]` - Text: `[p::high]`, `[priority::p1]` - Same value can't map to different priorities 3. **Default Priority** - Set default priority for tasks without explicit priority - Applied when no priority field is found - Configurable in settings (Priority 1-4) 4. **Priority Display** - Priority options shown in task creation modal - Displays both priority level and mapped values - Example: "Priority 1 (Highest) [1, high, p1]" - Makes it easy to see available priority options 5. **Usage Tips** - Use consistent notation within notes - Consider your existing workflow when choosing key - Map values that match your natural language - Example mappings: - Priority 1: `1, high, p1` - Priority 2: `2, medium, p2` - Priority 3: `3, low, p3` - Priority 4: `4, none, p4` ## Task Description Syncing The plugin offers two powerful commands for syncing task descriptions from Todoist back to your Obsidian notes: 1. **Sync description from Todoist task** - Retrieves the main task description content - Excludes metadata and reference links - Perfect for focusing on the actual task content - Maintains proper indentation and list structure - Example: ```markdown - [ ] Main task - [📎 View in Todoist](...) - Sub-task details from Todoist - Additional notes - List items preserved ``` 2. **Sync full description from Todoist task** - Includes complete task context - Preserves metadata and reference links - Maintains original task location references - Useful for complete context review - Example: ```markdown - [ ] Main task - [📎 View in Todoist](...) - Original task in Obsidian: obsidian://... - Reference: obsidian://... - Sub-task details from Todoist - Additional notes - List items preserved ``` ## Maintaining Temporal Context The plugin provides comprehensive timestamp tracking to maintain temporal context: 1. **PTKM Alignment**: - Timestamps are crucial for PTKM methodology - Provide temporal context for your knowledge and task management - Provide clear creation timestamps for better organization - Help track the evolution of your task system - Enable better understanding of task creation patterns - Enable temporal relationship tracking between tasks - Multiple layers of temporal tracking (metadata, links, block IDs) - Integrating temporal information into the reference system 2. **Todoist Task Description Timestamps**: - Automatically adds creation timestamp in the task's metadata section - Shows when the task was synced from Obsidian - Helps track the origin time of tasks 3. **Obsidian Link Timestamps**: - Adds creation timestamp after each Todoist task link - Provides temporal context right in your notes - Helps track when tasks were created 4. **Block ID Temporal Tracking**: - Default block ID format includes timestamp information - Enables tracking when blocks were created through their IDs - Provides another layer of temporal context - Integrates temporal information directly into reference system 5. **Customization**: - All temporal formats are independently customizable - Uses [[Moment.js Format|moment.js]] format for flexibility - Can include emojis and custom text ## Auto-Tagging and Label Management The plugin enhances task tracking reliability through its dual-platform approach: - **Obsidian Tags**: Automatically track tasks in your knowledge base - **Todoist Labels**: Organize tasks in your task management system - **Combined Benefits**: - Improved task visibility across platforms - Enhanced reliability through system redundancy - Flexible task filtering and organization This dual-platform approach aligns with the PTKM method's emphasis on reliable task management while maintaining rich context in your knowledge management system. The auto-tagging feature: - Automatically adds a customizable tag to tasks in Obsidian when synced to Todoist - No manual tagging needed before or after syncing - Provides an extra layer of redundancy for tracking important tasks: - Tasks are tracked in Obsidian through tags - Tasks are managed in Todoist through the task list - Double verification ensures nothing falls through the cracks - Aligns with PTKM principles: - **Reliable Redundancy**: Maintains task status in both systems - **Task-Centered Workflow**: Automates tracking without extra effort - **Focus on Priority**: Easily identify which important tasks are already in Todoist - Customizable tag name to match your workflow - Works seamlessly with [[Text Cleanup Patterns for Todoist Context Bridge|Text Cleanup Patterns]] (tags won't appear in Todoist) **Usage Tips:** - Place your cursor on a task line that is synced to Todoist - Choose the appropriate sync command based on your needs - Description content will be inserted with proper indentation - Empty descriptions or metadata-only content will be handled gracefully - Completed tasks cannot be synced to prevent conflicts ## Text Cleanup Patterns - [[Text Cleanup Patterns for Todoist Context Bridge]] ## Smart Content Format Handling The plugin intelligently handles various content formats during sync: - **List Items**: When syncing a Todoist task to a line that starts with a list marker (`-`, `*`, etc.) - **Task Items**: Properly converts Todoist tasks to Obsidian tasks (with checkboxes) - **Callouts & Block Quotes**: Maintains proper formatting when syncing inside these special blocks - **Cursor Position**: Preserves your editing position after syncing ## Learn More About Todoist Context Bridge - [[How to Use Todoist Context Bridge]] - [[Design Philosophy of Todoist Context Bridge]] - [[Bridging Tasks and Knowledge in Obsidian_Introducing the Todoist Context Bridge Plugin]] - [[The Importance of Context in Task and Knowledge Management_Leveraging the Obsidian Todoist Context Bridge Plugin]]