README file from
GithubCheckbox Autochecker (Obsidian Plugin)
Automatically sync parent and child checkboxes inside your Markdown files in Obsidian.
Supports hierarchical task lists with flexible propagation modes.
Features
- Automatically checks or unchecks parent tasks based on child completion.
- Downward propagation: toggle parent -> sync children automatically.
- 3 sync modes:
- Loose: only upward propagation (children -> parents).
- Partial Strict: toggle parent -> only update unchecked children.
- Strict: toggle parent -> overwrite all children.
- Works in real-time while typing.
- Fully supports nested checklists and multiple indentation levels.
- Fully compatible with native Obsidian Markdown files.
Limitations
- Only works on standard Markdown files (
.md). - Does not modify embedded Canvas nodes.
- Embedded Markdown files inside
.canvasdo work.
- Embedded Markdown files inside
Installation
Obsidian Community Plugins (recommended)
- Search for "Checkbox Autochecker" inside Obsidian's Community Plugin browser.
Manual Installation
- Download the latest release from the Releases page.
- Extract the contents into your Obsidian plugins folder:
- Create a new folder inside your Obsidian plugins directory named
checkbox-autochecker-obsidian. - Move the extracted files (
manifest.json,main.js) into this folder.
- Create a new folder inside your Obsidian plugins directory named
- Enable the plugin inside Obsidian.
Alternatively, you can also clone the repository and build the plugin yourself:
git clone https://github.com/klaasklee/checkbox-autochecker-obsidian.git
cd checkbox-autochecker-obsidian
npm install
npm run build
License
MIT License — see LICENSE for full terms.