table of contents
NVIM(1) | General Commands Manual | NVIM(1) |
NAME¶
nvim
— edit
text
SYNOPSIS¶
nvim |
[options] [file ...] |
nvim |
[options] - |
nvim |
[options] -t
tag |
nvim |
[options] -q
[errorfile] |
DESCRIPTION¶
nvim
is a text editor based on Vim. Start
nvim
followed by any number of options and/or
files:
nvim [options] [file
...]
Commands in nvim
begin with colon
(‘:’). Type ":help subject" to get help on a
specific subject. Use <Tab> and CTRL-D to complete subjects
(":help cmdline-completion").
The "quickref" help section is a condensed reference of editor features:
:help quickref
If you are new to Vim/Nvim, start with the 30-minute tutorial:
:Tutor
After installing/updating Nvim, it's a good idea to run the self-check:
:checkhealth
- file ...
- File(s) to edit. Opens one buffer per file. To switch between buffers, use
the
:next
and:previous
commands. -
- Reads text from standard input until
EOF
, then opens a buffer with that text. User input is read from standard error, which should be a terminal.
OPTIONS¶
-t
tag- Finds tag in the tags file, the associated file
becomes the current file and the associated command is executed. Cursor is
positioned at the tag location in the file.
:help tag-commands
-q
[errorfile]- QuickFix mode. Display the first error in errorfile.
If errorfile is omitted, the value of the
'errorfile' option is used (defaults to
errors.err
). Further errors can be jumped to with the:cnext
command.:help quickfix
--
- End of options. Remaining arguments are treated as literal file names, including filenames starting with hyphen (‘-’).
-e
- Ex mode, reading stdin as Ex commands.
:help Ex-mode
-E
- Ex mode, reading stdin as text.
:help Ex-mode
-es
- Silent (non-interactive) Ex mode, reading stdin as Ex commands. Useful for
scripting because it does NOT start a UI, unlike
-e
.:help silent-mode
-Es
- Silent (non-interactive) Ex mode, reading stdin as text. Useful for
scripting because it does NOT start a UI, unlike
-E
.:help silent-mode
-d
- Diff mode. Show the difference between two to four files, similar to
sdiff(1).
:help diff
-R
- Read-only mode. Sets the 'readonly' option. Implies
-n
. Buffers can still be edited, but cannot be written to disk if already associated with a file. To overwrite a file, add an exclamation mark to the relevant Ex command, such as:w!
.:help 'readonly'
-Z
- Restricted mode. Disable commands that make use of an external shell.
-m
- Resets the 'write' option, to disable file modifications. Writing to a file is disabled, but buffers can still be modified.
-M
- Resets the 'write' and 'modifiable' options, to disable file and buffer modifications.
-b
- Binary mode.
:help edit-binary
-l
- Lisp mode. Sets the 'lisp' and 'showmatch' options.
-A
- Arabic mode. Sets the 'arabic' option.
-H
- Hebrew mode. Sets the 'hkmap' and 'rightleft' options.
-V
[N][file]- Verbose mode. Prints debug messages. N is the
'verbose' level, defaults to
10
. If file is specified, append messages to file instead of printing them.:help 'verbose'
-D
- Debug mode for VimL (Vim script). Started when executing the first command from a script. :help debug-mode
-n
- Disable the use of swap files. Sets the 'updatecount' option to
0
. Can be useful for editing files on a slow medium. -r
[file]- Recovery mode. If file is omitted then list swap
files with recovery information. Otherwise the swap file
file is used to recover a crashed session. The swap
file has the same name as the file it's associated with, but with
‘.swp’ appended.
:help recovery
-L
[file]- Alias for
-r
. -u
vimrc- Use vimrc instead of the default
~/.config/nvim/init.vim. If
vimrc is
NORC
, do not load any initialization files (except plugins), and do not attempt to parse environment variables. If vimrc isNONE
, loading plugins is also skipped.:help initialization
-i
shada- Use shada instead of the default
~/.local/share/nvim/shada/main.shada. If
shada is
NONE
, do not read or write a ShaDa file.:help shada
--noplugin
- Skip loading plugins. Implied by
-u NONE
. --clean
- Skip loading plugins and shada (viminfo) file.
-o
[N]- Open N windows stacked horizontally. If N is omitted, open one window for each file. If N is less than the number of file arguments, allocate windows for the first N files and hide the rest.
-O
[N]- Like
-o
, but tile windows vertically. -p
[N]- Like
-o
, but for tab pages. +
[linenum]- For the first file, position the cursor on line
linenum. If linenum is
omitted, position the cursor on the last line of the file.
+5
and-c 5
on the command-line are equivalent to:5
insidenvim
. +/
[pattern]- For the first file, position the cursor on the first occurrence of
pattern. If pattern is
omitted, the most recent search pattern is used (if any).
+/foo
and-c /foo
on the command-line are equivalent to/foo
and:/foo
insidenvim
.:help search-pattern
- +command,
-c
command - Execute command after reading the first file. Up to
10 instances allowed. "
+foo
" and-c "foo"
are equivalent. --cmd
command- Like
-c
, but execute command before processing any vimrc. Up to 10 instances of these can be used independently from instances of-c
. -S
[session]- Source session after the first file argument has
been read. Equivalent to
-c "source session"
. session cannot start with a hyphen (‘-’). If session is omitted then Session.vim is used, if found.:help session-file
-s
scriptin- Read normal mode commands from scriptin. The same
can be done with the command
:source! scriptin
. If the end of the file is reached beforenvim
exits, further characters are read from the keyboard. -w
scriptout- Append all typed characters to scriptout. Can be
used for creating a script to be used with
-s
or:source!
. -W
scriptout- Like
-w
, but truncate scriptout. --startuptime
file- During startup, append timing messages to file. Can be used to diagnose slow startup times.
--api-info
- Dump API metadata serialized to msgpack and exit.
--embed
- Use standard input and standard output as a msgpack-rpc channel. :help --embed
--headless
- Do not start a UI. When supplied with --embed this implies that the embedding application does not intend to (immediately) start a UI. Also useful for "scraping" messages in a pipe. :help --headless
--listen
address- Start RPC server on this pipe or TCP socket.
-h
,--help
- Print usage information and exit.
-v
,--version
- Print version information and exit.
ENVIRONMENT¶
NVIM_LOG_FILE
- Low-level log file, usually found at ~/.local/share/nvim/log. :help $NVIM_LOG_FILE
VIM
- Used to locate user files, such as init.vim. System-dependent. :help $VIM
VIMRUNTIME
- Used to locate runtime files (documentation, syntax highlighting, etc.).
XDG_CONFIG_HOME
- Path to the user-local configuration directory, see FILES. Defaults to ~/.config. :help xdg
XDG_DATA_HOME
- Like
XDG_CONFIG_HOME
, but used to store data not generally edited by the user, namely swap, backup, and ShaDa files. Defaults to ~/.local/share. :help xdg VIMINIT
- Ex commands to be executed at startup.
:help VIMINIT
SHELL
- Used to initialize the 'shell' option, which decides the default shell
used by features like
:terminal
,:!
,and
system()
.
FILES¶
- ~/.config/nvim/init.vim
- User-local
nvim
configuration file. - ~/.config/nvim
- User-local
nvim
configuration directory. See alsoXDG_CONFIG_HOME
. - $VIM/sysinit.vim
- System-global
nvim
configuration file. - /usr/local/share/nvim
- System-global
nvim
runtime directory.
AUTHORS¶
Nvim was started by Thiago de Arruda. Most
of Vim was written by Bram Moolenaar. Vim is based
on Stevie, worked on by Tim Thompson,
Tony Andrews, and G.R. (Fred)
Walter. :help credits
December 17, 2017 | Debian |