This is an initiative to help standardize the Alternative Checkboxes feature commonly used by the community in Obsidian.md.
The result is a Reference Set CSS and supporting Usage Guide which is there to serve as a foundation for customisation, creating other Alternative Checkbox sets and encouraging theme developers to implement toggle options for their built in Alternative Checkboxes. This allows users to use their own snippets without hacky overwrites.
We achieved this by analyzing all publicly available implementations of Alternative Checkboxes within Obsidian be it as a Theme, CSS Snippet or Plugin and creating an easy to customise snippet.
You can review the research that went into this by downloading the Research Vault from the Releases section and opening the folder in Obsidian.
| Light / Dark Theme |
|---|
 |
Please refer to the Usage Guide for information on how to use the Reference Set snippet, implement toggles in your theme for your current Alternative Checkboxes implementation, as well as, how to make your own set based on the reference.
Previously, all discussion regarding this initiative was carried out in a thread within the Official Obsidian Discord. To see the archive visit here: https://discord.com/channels/686053708261228577/1291469509336502272
Going forward, please use the Issues section in this repository to report any issues, ask for help with implementing toggles in your theme or creating your own Alternative Checkbox sets, etc.
At the moment, there are no direct guidelines for contributing to this repository. Ideally, any contributions should be discussed in an Issue first.
Special thanks to the following people for their direct contributions to this repository:
- claremacrae - For assisting in parsing through all available themes in Obsidian's Community Themes Store.
- ElsaTam - For reviewing the CSS in each theme to identify the patterns used to implement the feature.
- sigrunixia - For helping with the Repository maintenance and outward tasks like presenting the initiative to new themes.
Also, big thanks to everyone that contributed feedback over in the Discord Thread.
The Research Vault contains Themes, CSS Snippets and Plugins which were added for convenience of previewing the relevant documentation. Here are the licenses which they are distributed under:
Themes
- Minimal - Distributed under the MIT License
- Things - Distributed under the MIT License
- Blue Topaz - Distributed under the MIT License
- AnuPpuccin - Distributed under the GPL-3.0 License
- Sanctum - Distributed under the MIT License
- ITS - Distributed under the GPL-2.0 License
- Primary Distributed under the GPL-3.0 License
- Tokyo Night - Distributed under the MIT License
- Border - Distributed under the MIT License
- Spectrum - Distributed under the MIT License
- Cyber Glow - Distributed under the MIT License
- LYT Mode - Distributed under the MIT License
- Shiba Inu - Distributed under the MIT License
- PLN - Distributed under the GPL-3.0 License
- Obsidianotion - Distributed under the Unlicense License
- Maple - Distributed under the MIT License
- Ebullientworks - Distributed under the CC0-1.0 License
- Pine Forest Berry - Distributed under the MIT License
- Aura - Distributed under the GPL-2.0 License
- Vicious - Distributed under the MIT License
- Simple - Distributed under the Unlicense License
- Elegance - Distributed under the MIT License
- Material Ocean - Distributed under the MIT License
- Sparkling Night - Distributed under the MIT License
- Kakano - Distributed under the MIT License
- Neo - Distributed under the MIT License
- Feather - Distributed under the MIT License
- Listive - Distributed under the MIT License
- MagicUser - Distributed under the MIT License
- Qlean - Distributed under the MIT License
- Yue - Distributed under the MIT License
- sQdthOne - Distributed under the GPL-3.0 License
- Dracula Plus - Distributed under the MIT License
- Solitude - Distributed under the MIT License
- Prime - Distributed under the GPL-3.0 License
- Sanctum Reborn - Distributed under the MIT License
- Underwater - Distributed under the MIT License
- Nightingale - Distributed under the MIT License
- Reshi - Distributed under the GPL-3.0 License
- Shade Sanctuary - Distributed under the MIT License
- Sparkling Day - Distributed under the MIT License
- Oreo - Distributed under the GPL-3.0 License
- Gummy Revived - Distributed under the MIT License
- Lorens - Distributed under the MIT License
- Fancy-a-Story - Distributed under the MIT License
- Borealis - Distributed under the MIT License
CSS Snippets
- ITS Alternative Checkboxes - Distributed under the GPL-2.0 License
- Phoenix Checkboxes - Distributed under the MIT License
Plugins
- Style Settings - Distributed under the GPL-3.0 License
- Editor Shortcuts - Distributed under the MIT License
- Tasks - Distributed under the MIT License
- Snippetor - Distributed under the AGPL-3.0 License
- ToggleList - Distributed under the MIT License
The inclusion of the Themes / CSS Snippets / Plugins in the vault are strictly for research purposes. If you are an author of any of them and would like me to remove them from this repository, please let me know by creating an issue.
The Documentation itself (Markdown files) are under the Unlicense License, unless another license is noted, especially next to code snippets from the themes.
The Alternative Checkbox Reference Set CSS file is also under the Unlicense License to prevent any issues with creating derivative works based on it.
The icons used in the Reference Set CSS are Lucide. Lucide is distributed under the ISC License.