GutterMarks.nvim

2025-08-03

GutterMarks.nvim

I love neovim Marks, this weekend, I got tired by existing neovim Marks plugins. They are often complex, impose new workflows and sometimes don't provide the basics very well out of the box: display the Marks in the buffer gutter.

For example, marks.nvim runs a scheduled function every 150 milliseconds to refresh the existing marks, both not great for performances and slow. Futher, I don't need all the other fancy features.

So I wrote GutterMarks.nvim.

The pitch is simple: display in the Neovim gutter the existing Marks for a given buffer.

GutterMarks screenshot

There are a few configuration options:

And that's it. Nothing fancy.

Installation is simple using lazy.nvim

{
  "dimtion/guttermarks.nvim",
  event = "VeryLazy",
}

Using Rosé Pine theme, I'm changing the gutter marks color using the highlight groups override:

  {
    "rose-pine/neovim",
    name = "rose-pine",
    lazy = false,
    priority = 1000,
    opts = {
      highlight_groups = {

        -- Blend colours against the "base" background
        CursorLine = { bg = "pine", blend = 30 },
	
		...

        GutterMarksLocal = { fg = "muted" },
        GutterMarksGlobal = { fg = "muted" },
        GutterMarksSpecial = { fg = "muted" },
      },
    },
  },


I'm not planning to add much other features, in particular to keep the scope small. But if you find any bugs or nice to have improvements, don't hesitate to file a bug report. Hope this plugin will find other happy users!