This extension is designed to enhance the functionality of the checkbox in markdown files. It is designed to work with the markdown preview and the markdown editor.
I'm using this extension to learn how to create a Visual Studio Code extension while also solving a problem that I have. I hope you find it useful too.
Note
This extension is in development. If you find any bugs or have any feature requests, please open an issue on the GitHub repository
Once activated, the extension will show a counter in the status bar of Visual Studio Code. The counter will show the number of checked checkboxes and the percentage of checked checkboxes in the document.
-
You can change the format of the counter by clicking on it or executing the
Checkbox Enhancement: Change Counter Format
command.demo.mp4
-
To show/hide the counter, you can use the
Checkbox Enhancement: Toggle Counter
command. -
The counter will be updated every time you save or change the document and the color of the counter will change according to the percentage of checked checkboxes.
More features will be added in the future.
Check the CHANGELOG.md file for the release notes.
You can use this extension alongside
progress-bar.dev
to show the progress of your
checkboxes in your markdown files.
Create a list of checkboxes in your markdown file and use the following format:
- [x] really cool feature
- [ ] another cool feature but not as cool as the first one
- [X] an important task!
- [ ] a task that is not so important
![progress](https://progress-bar.dev/50?title=progress)
And you will get the following result:
Contributions / asking for features are welcome. Feel free to open an issue or a pull request on the GitHub repository of the project.
These are some of the features that I would like to add in the future:
- Color change according to the percentage of checked checkboxes
- Mode for show both percentage and number of checked checkboxes
- Option to show the counter in the markdown preview
- Option to show the counter for separate lists in the document
To contribute, clone the repository first:
git clone [email protected]:jamerrq/checkbox-md-enhancement.git
Then, install the dependencies:
cd checkbox-md-enhancement
pnpm install
After that, you can open the project in Visual Studio Code and start developing.
Use the F5
key to start the extension in a new window.
I strongly recommend creating a new branch for your changes.
git checkout -b feature/my-new-feature
When you are done, you can open a pull request on the GitHub repository.