Skip to content

Add visual indicators to files in the file explorer based on configurable rules

License

Notifications You must be signed in to change notification settings

remyhonig/obsidian-conditional-marker

Repository files navigation

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

Condition Description
Has task with marker Unchecked task contains specific text (e.g., #next)
No task has marker No unchecked task contains the marker
Has tasks but none with marker File has tasks, but none contain the marker

Task Status

Condition Description
Has tasks File contains at least one task (checked or unchecked)
Has no tasks File contains no tasks
Has incomplete tasks File has at least one unchecked task
All tasks completed Every task in the file is checked

File Location

Condition Description
File is in folder File path starts with specified folder
File is not in folder File is outside the specified folder

Tags

Condition Description
File has tag Frontmatter contains the specified tag
File does not have tag Frontmatter does not contain the tag

Frontmatter Properties

Condition Description
File has property with value Property equals the specified value
File does not have property Property is missing from frontmatter
File has property without value Property exists but doesn't equal the value

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

Badge Styles

Style Description
Colored dot Small colored circle
Text label Text badge with background color
Icon/emoji Any emoji or symbol
Strikethrough Crosses out the filename
Dimmed Reduces opacity
Accent bar Colored left border
Background Subtle 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.

About

Add visual indicators to files in the file explorer based on configurable rules

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published