Stupidly simple neovim plugin that toggles task list check boxes in markdown using treesitter.
This plugin requires my other plugin - treesitter-utils.
Use your favorite package manager.
lazy.nvim
:
{
'nfrid/markdown-togglecheck',
dependencies = { 'nfrid/treesitter-utils' },
ft = { 'markdown' },
}
You don't need to execute a setup function to use the defaults but in case you
want to redefine them, you can do it with setup
:
require('markdown-togglecheck').setup({
-- create empty checkbox on item without any while toggling
create = true,
-- remove checked checkbox instead of unckecking it while toggling
remove = false,
})
The plugin does not provide default keybindings.
You should define them yourself:
-- toggle checked / create checkbox if it doesn't exist
vim.keymap.set('n', '<leader>nn', require('markdown-togglecheck').toggle, { desc = 'Toggle Checkmark' });
-- toggle checkbox (it doesn't remember toggle state and always creates [ ])
vim.keymap.set('n', '<leader>nN', require('markdown-togglecheck').toggle_box, { desc = 'Toggle Checkbox' });
If you need dot repeat for this plugin you can use operatorfunc
to bind the keys
(they'll work the same way but will provide . repeat functionality):
local function toggle()
vim.go.operatorfunc = "v:lua.require'markdown-togglecheck'.toggle"
return 'g@l'
end
local function toggle_box()
vim.go.operatorfunc = "v:lua.require'markdown-togglecheck'.toggle_box"
return 'g@l'
end
vim.keymap.set('n', '<leader>nn', toggle, { expr = true, desc = 'Toggle Checkmark' })
vim.keymap.set('n', '<leader>nN', toggle_box, { expr = true, desc = 'Toggle Checkbox' })
You also might add some highlight queries yourself for the check boxes. For example:
;; YOUR_CONFIG/after/queries/markdown/highlights.scm
; inherits: markdown
(task_list_marker_unchecked) @comment
(task_list_marker_checked) @function