Neovim

Bem-vindo à Enciclopédia Neovim, seu guia completo sobre o editor de texto modal open source em português.

Seções

Explore as quatro seções principais do guia:

• Enciclopédia — Referência completa de conceitos: modos, motions, operators, text-objects, registers, marks, jumps, autocommands, keymaps, comandos-ex, Lua API e options
• Tutoriais — Guias práticos de instalação, configuração de LSP, Treesitter, Telescope, DAP e mais
• Exemplos — Receitas de init.lua, dotfiles, comparação Vimscript vs Lua e scripts em headless mode
• Recursos — FAQ, glossário, links úteis e referências oficiais

Por Onde Começar

Se você nunca usou um editor modal, siga nesta ordem — cada passo pressupõe o anterior:

1. Instalação — colocar o Neovim v0.11+ para rodar
2. Modos do Neovim — o modelo que explica tudo o mais
3. Motions, operators e text objects — a gramática da edição modal
4. Buffers, janelas e abas — o modelo que mais confunde quem vem de outros editores
5. init.lua básico — a primeira configuração, sem plugins
6. Gerenciador de plugins — quando a falta começar a incomodar
7. LSP, Treesitter e Telescope — as três ferramentas que cobrem a maior parte do fluxo

Se você vem do VS Code, comece por migrar do VS Code, que descreve o caminho em etapas e diz honestamente o que se perde.

Quem já usa o Neovim há algum tempo costuma tirar mais proveito de macros, busca e substituição e quickfix — as três ferramentas de edição em massa.

Índices

• Índice por tema — todo o conteúdo agrupado por seção, nível e assunto
• Índice enciclopédico — todas as páginas em ordem alfabética

Se algo não está funcionando, comece por solução de problemas.

Versão Alvo

Este guia cobre o Neovim v0.11 ou mais recente. A série 0.11 é o corte que importa: foi ela que trouxe vim.lsp.config/vim.lsp.enable para o núcleo e tornou obsoleto o require("lspconfig").X.setup{} que ainda aparece na maior parte do material disponível na internet.

A versão estável mais recente no momento desta revisão (29 de julho de 2026) é a v0.12.4. O nvim-lspconfig exige 0.11.3 ou superior e já anunciou a remoção do suporte ao 0.10.

Contribua

Este guia foi gerado com auxílio de inteligência artificial e vem sendo continuamente revisado por um humano. Correções, complementos e relatos de erro são muito bem-vindos.

• Repositório: https://forgejo.singularjourney.org/devjonatas/guia-nvim — abra uma issue ou mande um patch
• Encontrou algo errado? Abrir uma issue apontando a página e o problema já ajuda bastante

Se o material lhe foi útil de alguma forma e você quiser retribuir, há uma chave Pix disponível:

Pix: contact@jonatasoliveira.dev

Não há nada bloqueado atrás disso — todo o conteúdo é e continuará livre. Quem contribuir, com código ou com Pix, será registrado nos agradecimentos abaixo, salvo pedido em contrário.

Agradecimentos

Às pessoas que contribuíram com este guia:

Ainda não há contribuições registradas. Se você contribuir, seu nome aparece aqui.