What is org-bullets.nvim?

Org-bullets.nvim is a visual enhancement plugin for Neovim users who write notes and documents in Org-mode syntax. It replaces the plain asterisk characters that normally mark headings, list items, and checkboxes with nicer-looking Unicode symbols, making your Org files more visually organized and easier to scan at a glance. The plugin is designed to work alongside orgmode.nvim, a broader project that brings Org-mode functionality to Neovim. Under the hood, it uses a Neovim feature called "extmarks" to swap the displayed characters, rather than using the simpler "conceal" approach that Neovim also offers. The developer chose this route because conceal has limitations, it only supports a single global highlight color, and it stops working when a section of text is folded up. Extmarks avoid both problems, giving you more flexibility in how things look. This tool is for people who already use Neovim as their primary text editor and rely on Org-mode for task management, note-taking, or outlining. If your daily workflow involves toggling checkboxes, nesting headings several levels deep, and folding sections to stay focused, this plugin makes those elements visually distinct instead of a wall of identical asterisks. You can customize which symbols appear at each heading level, adjust how checkboxes look in their different states (todo, half-done, complete), and even apply custom color highlighting per level. Setting it up requires Neovim version 0.7 or newer and a parser called tree-sitter-org, which helps Neovim understand the structure of your Org files. The README notes that a simpler conceal-based alternative exists using a few lines of Vim syntax commands, but that approach comes with the tradeoffs mentioned above. The project itself is written in Lua, the scripting language commonly used for modern Neovim plugins.