project

nvim-bookmarks

A simple bookmark system for Neovim focused on marking files and lines and restoring working context quickly.

1 related articles

nvim-bookmarks is a small bookmark system for Neovim, in Lua. Not a formal plugin – it’s a single bookmark.lua file that you load from your init.lua.

I built it because, day to day, I keep going back to the same files and lines to debug and test something. Opening those files directly at the right line, without navigating, makes a real difference when you’re chasing a bug.

The marks file format is deliberately simple: full file path, space, +, line number. One mark per line. I use the same format in other scripts outside Neovim, so everything talks to itself.

Default mappings:

  • <leader>m – marks the current file and line in ~/marks.txt
  • <leader>o – opens every bookmark (from home and from the current directory)
  • :Clearmarks – clears the bookmarks

You can also have a project-specific marks.txt inside the working directory. I rarely use it, but it’s there.

The full code walkthrough and the reasoning behind each decision are in the article (currently in Portuguese): Criando um Sistema de Bookmarks no Neovim com Lua.