Neovim for Minimalists — mini.nvim

Configure the minimal, independent, and fast Lua modules to improve the Neovim experience.

Neovim for Minimalists — mini.nvim

In this article, we are going to improve the development experience for our minimal Neovim configuration using the mini.nvim plugin.

This article is part of the Neovim for Minimalists series.

The Neovim configuration files are available in this repository.

Getting Started

We use the mini.nvim plugin in our existing configuration. This plugin has many different independent modules suitable for most common tasks. We will explore several Lua modules provided by this plugin.

mini.jump2d

This module (:h mini.jump2d) is for jumping (moving cursor) within visible lines via iterative label filtering.

mini.jumpd2d

• In the above screenshot, we trigger the jump by pressing ENTER.
• We want to jump from the left-most window to the line in the middle window containing the word sumneko_lua.
• This highlights all possible jump spots with their labels (letters from “a” to “z” by default).
• We press the labels to jump to the target location.

We configure this module in the lua/config/mini/init.lua file using the default settings.

require("mini.jump2d").setup({})

The default key mapping to start jumping is theENTER key (:h MiniJump2d.config).

We can configure the module to use another key. For example, to start jumping when pressing the character S in normal mode.

require("mini.jump2d").setup({
  mappings = {
    start_jumping = 'S',
  },
})

Using the highlight group, we can change the highlighting of the jump spots. For example,

hi MiniJump2dSpot guifg=#7cccf3 guibg=#a25c41