Skip to content

Linux Neovim Guide

Mattscreative edited this page Dec 5, 2025 · 2 revisions

Linux Neovim Guide

Complete beginner-friendly guide to Neovim on Linux, covering Arch Linux, CachyOS, and other distributions including installation, configuration, plugins, and modern Vim features.


Table of Contents

  1. Neovim Installation
  2. Neovim Basics
  3. Neovim Configuration
  4. Plugins
  5. Troubleshooting

Neovim Installation

Install Neovim

Arch/CachyOS:

# Install Neovim
sudo pacman -S neovim

# Install Python support
sudo pacman -S python-neovim

Debian/Ubuntu:

sudo apt install neovim

Fedora:

sudo dnf install neovim

Launch Neovim

Start Neovim:

# Open file
nvim filename.txt

# Or
vim filename.txt

Neovim Basics

Vim Compatibility

Neovim is Vim-compatible:

  • Same commands: All Vim commands work
  • Better defaults: Improved out of the box
  • Modern features: Better terminal integration

Basic Usage

See Vim Guide for basic Vim commands.


Neovim Configuration

Configuration File

Edit config:

# Create config directory
mkdir -p ~/.config/nvim

# Edit init file
vim ~/.config/nvim/init.vim

# Or Lua config
vim ~/.config/nvim/init.lua

Basic Configuration

init.vim:

" Enable line numbers
set number

" Enable syntax highlighting
syntax on

" Set tab size
set tabstop=4
set shiftwidth=4

" Enable mouse
set mouse=a

Plugins

Plugin Managers

Install plugin manager:

# vim-plug
sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
       https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'

Install Plugins

Add plugins:

" In init.vim
call plug#begin('~/.config/nvim/plugged')

Plug 'plugin-name'

call plug#end()

Troubleshooting

Neovim Not Starting

Check installation:

# Check Neovim
which nvim
nvim --version

# Install if missing
sudo pacman -S neovim

Summary

This guide covered Neovim installation, configuration, and plugins for Arch Linux, CachyOS, and other distributions.


Next Steps


This guide covers Arch Linux, CachyOS, and other Linux distributions. For distribution-specific details, refer to your distribution's documentation.

Clone this wiki locally