Bullet

Work with your lists like in Workflowy or RoamResearch

This plugin is forked from vslinko/obsidian-outliner.

📦 Latest release
🐛 Report issues

Requires Obsidian 1.12.7 or later.

How to install

From within Obsidian

You can activate this plugin within Obsidian by doing the following:

• Open Settings > Third-party plugin
• Make sure Safe mode is off
• Click Browse community plugins
• Search for "Bullet"
• Click Install
• Once installed, close the community plugins window and activate the newly installed plugin

Manual installation

Download main.js, manifest.json, styles.css from the latest release and put them into <vault>/.obsidian/plugins/bullet folder.

How to use

Try to create a deeply structured list and move items by pressing the hotkeys described below.

Features

Improve the style of your lists

If you liked the styles from the demo above, you can enable them in the plugin settings tab.

Disclaimer: Styles are only compatible with built-in Obsidian theme.

Move lists back and forth

Move lists with children wherever you want without breaking the structure. This also works for a single multiline selection and is available from mobile commands and toolbar actions.

Draw vertical indentation lines

Disclaimer: vertical indentation lines are only compatible with built-in Obsidian theme.

Stick the cursor to the content

Keep the caret inside the editable text instead of letting it drift into the hidden markdown prefix. This affects arrow-key navigation, deletion, and text selection in Live Preview.

• Never: let the caret move anywhere, including the bullet and checkbox markup.
• Stick cursor out of bullets: keep the caret out of the bullet marker such as - or 1. , but allow it inside checkbox markup.
• Stick cursor out of bullets and checkboxes: keep the caret out of both the bullet marker and checkbox markup such as - [ ] or - [x] .

This is useful if you want list editing to feel closer to an outliner or block editor, where the caret stays on the content and keyboard actions operate on the text instead of the markdown syntax.

Hold Alt or Option while navigating or clicking to temporarily place the caret inside the hidden bullet or checkbox markup without changing the setting.

Enhance the Enter key

Make the Enter key behave the same as other outliners:

• Enter outdents list item if it's empty.
• Enter creates new line on children level if there are any children.
• Enter on an existing note line continues that note line.
• Shift-Enter creates a new note line.
• Ordered lists defer to Obsidian when Smart lists is disabled.

Additional command:

Fold and unfold your lists

Enhance the CtrlA or CmdA behavior

Press the hotkey once to select the current list item. Press the hotkey twice to select the entire list.

Vim-mode o and O

When Obsidian Vim mode is enabled, pressing o or O inside a list creates a proper sibling bullet instead of a plain line. Outside lists, the plugin falls back to plain-line insertion.

Drag-and-Drop

Debug mode

Open DevTools (Command+Option+I or Control+Shift+I) to copy the debug logs.