Conditional Marker

pending

by Remy Honig

Add visual indicators to files in the file explorer based on configurable rules. Perfect for GTD workflows, project management, and task tracking.

2 starsUpdated 3mo ago0BSDDiscovered via Obsidian Unofficial Plugins
View on GitHub

Conditional Marker

Add visual indicators to files based on their content. See at a glance which notes need attention, have pending tasks, or match your custom criteria.

Features

  • Visual badges in the file explorer and editor header
  • Flexible conditions based on tasks, tags, folders, and frontmatter properties
  • Multiple badge styles: colored dots, text labels, icons/emoji, strikethrough, dimmed, accent bars
  • Combine conditions with AND/OR logic for precise matching
  • Multiple badges per rule with different styles for file explorer vs editor header

Use Cases

GTD Workflow

  • Show a red dot on notes with tasks but no #next action defined
  • Mark notes with #waiting or #blocked tasks with distinctive icons

Project Management

  • Highlight active projects in a specific folder
  • Dim completed projects where all tasks are done
  • Show accent bars on high-priority items

Content Status

  • Mark drafts vs published content using frontmatter properties
  • Flag notes that need review with a tag condition

Conditions

Task Markers

ConditionDescription
Has task with markerUnchecked task contains specific text (e.g., #next)
No task has markerNo unchecked task contains the marker
Has tasks but none with markerFile has tasks, but none contain the marker

Task Status

ConditionDescription
Has tasksFile contains at least one task (checked or unchecked)
Has no tasksFile contains no tasks
Has incomplete tasksFile has at least one unchecked task
All tasks completedEvery task in the file is checked

File Location

ConditionDescription
File is in folderFile path starts with specified folder
File is not in folderFile is outside the specified folder

Tags

ConditionDescription
File has tagFrontmatter contains the specified tag
File does not have tagFrontmatter does not contain the tag

Frontmatter Properties

ConditionDescription
File has property with valueProperty equals the specified value
File does not have propertyProperty is missing from frontmatter
File has property without valueProperty exists but doesn't equal the value

All conditions can be combined with AND/OR groups for complex matching.

Badge Styles

StyleDescription
Colored dotSmall colored circle
Text labelText badge with background color
Icon/emojiAny emoji or symbol
StrikethroughCrosses out the filename
DimmedReduces opacity
Accent barColored left border
BackgroundSubtle background highlight

Getting Started

  1. Open Settings → Conditional Marker
  2. Click "Add rule" to create your first rule
  3. Set conditions that match your files
  4. Choose a badge style and location
  5. Enable the rule

The plugin comes with pre-configured GTD rules that you can enable or customize.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.