README file from
GithubCheckers 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
- Download
main.js,manifest.json, andstyles.cssfrom a release. - Create this folder in your vault:
<vault>/.obsidian/plugins/checkers-hider/
- Put the three files into that folder.
- Reload Obsidian.
- Enable
Checkers Hiderin 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 inTask 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.