Checkers Hider

approved

by Andrei

Hide or show completed and custom-status checklist items in Obsidian. - This plugin has not been manually reviewed by Obsidian staff.

↓ 144 downloadsUpdated 2mo agoMIT
Install in ObsidianView on GitHub

Checkers Hider

Hide completed and custom-status checklist items in Obsidian without changing your notes.

Checkers Hider can hide regular completed tasks like [x] and custom checkbox markers like [-] or [/].

Features

  • Hide or show matching checklist items with a command, status bar icon, or optional ribbon button.
  • Hide completed tasks by default: [x] and [X].
  • Configure custom task markers such as -, /, ?, !, or any other single character.
  • Choose whether the marker list means "hide these markers" or "keep these markers visible".
  • Optionally hide nested bullets under a hidden task.
  • Optionally show all checkboxes while editing, while still hiding them in preview.
  • Disable hiding on specific pages with an inline or frontmatter tag.

Tested Views

  • Reading view.
  • Source mode and Live Preview.
  • Hover preview popovers.
  • Kanban boards.
  • Canvas cards.
  • Dataview task lists, including DataviewJS task lists in Canvas.

Install

  1. Download main.js, manifest.json, and styles.css from a release.
  2. Create this folder in your vault:
<vault>/.obsidian/plugins/checkers-hider/
  1. Put the three files into that folder.
  2. Reload Obsidian.
  3. Enable Checkers Hider in Settings -> Community plugins.

Usage

Use Toggle Checkers Hider from the command palette, the status bar checkbox icon, or the optional ribbon button.

The status bar icon is dark green when hiding is enabled and gray when it is disabled.

Settings

Task marker mode

  • Hide listed markers: hides only markers listed in Task markers.
  • Keep listed markers: keeps [ ] and listed markers visible, then hides other non-empty task statuses.

Task markers

Every character in this field is treated as a marker. Do not add separators unless you also want them to match.

xX-/

Hide sub-bullets

In Source mode and Live Preview, also hides indented bullets and nested tasks under a hidden task. In rendered views, Obsidian usually renders nested content inside the parent task item, so it is hidden with the parent.

Show all checkboxes in edit mode

Keeps Source mode, Live Preview, and popover editing fully visible while preview modes still hide matching tasks.

Page override tags

Show matching tasks on specific pages even when hiding is globally enabled.

Default tags:

checkers-show-completed, ctd-show-completed

You can use an inline tag:

#checkers-show-completed

Or frontmatter:

---
tags:
  - checkers-show-completed
---

Credits

Based on heliostatic/completed-task-display by Ben Lee-Cohen.

License

MIT License. See LICENSE.

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.