Neovim

Neovim is an extended version of the modal editor Vim.

You can install it with:

brew install neovim

I generally use this with VSCode using VSCode Neovim.

Configuration

Config is usually written in Lua and is stored under ~/.config/nvim/init.lua.

Vim Options

For something that would normally be in Vimscript like:

set relativenumber

Lua does it like:

vim.opt.relativenumber = true

VSCode Comments

If using VSCode Neovim, then the usual comment hotkey (⌘+/) won't work. To fix this, add the following to the Neovim config:

-- Fix CMD+/ keybinding for vscode 
vim.api.nvim_set_keymap('x', 'gc', '<Plug>VSCodeCommentary', {}) vim.api.nvim_set_keymap('n', 'gc', '<Plug>VSCodeCommentary', {}) vim.api.nvim_set_keymap('o', 'gc', '<Plug>VSCodeCommentary', {}) vim.api.nvim_set_keymap('n', 'gcc', '<Plug>VSCodeCommentaryLine', {}) vim.api.nvim_set_keymap('n', '<D-/>', 'gcc', {}) vim.api.nvim_set_keymap('x', '<D-/>', 'gc', {})

Finally, under VSCode's keybindings.json, add the following:

{
    "command": "vscode-neovim.send",
    "key": "cmd+/",
    "when": "editorTextFocus && neovim.mode != insert",
    "args": "<D-/>"
}

Plugins

lazy.nvim

Which plugin manager to use changes with the moon phase 🌙. At the moment it is lazy.nvim.

Install it by mindlessly copy/pasting this into your config.

local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
if not vim.loop.fs_stat(lazypath) then
  vim.fn.system({
    "git",
    "clone",
    "--filter=blob:none",
    "https://github.com/folke/lazy.nvim.git",
    "--branch=stable", -- latest stable release
    lazypath,
  })
end
vim.opt.rtp:prepend(lazypath)

nvim-surround

nvim-surround is a newer version of Tim Pope's famous surround.vim.

Usage is one of ys, cs, or ds, then either a motion and a surrounding character or just the surrounding character.

"this is a quote"
> I then enter ds"
It becomes
this is a quote

Install into your config with this lazy.nvim Lua:

{
    "kylechui/nvim-surround",
    version = "*",
    event = "VeryLazy",
    config = function()
        require("nvim-surround").setup({
            -- Configuration here, or leave empty to use defaults
        })
    end
}