| name | dotfiles-nvim |
| description | Neovim configuration in ~/.config/.dotfiles/nvim.
Use when the user asks about Neovim setup, keymaps, plugins, LSP, formatting,
markdown editing, Obsidian integration, Treesitter, or any nvim-related changes.
Covers the full config: lazy.nvim, LazyVim, 30+ plugin specs, and keymaps.
|
Neovim Configuration
Location: ~/.config/.dotfiles/nvim/
Architecture
Uses lazy.nvim (folke) as plugin manager with LazyVim as the base
distribution. Plugins are configured as individual spec files under lua/plugins/.
nvim/
├── init.lua -- Entry point
├── lazy-lock.json -- 78 locked plugins
├── lazyvim.json -- LazyVim extras registry
├── stylua.toml
├── lua/
│ ├── config/
│ │ ├── lazy.lua -- Lazy.nvim bootstrap + LazyVim import
│ │ ├── options.lua -- Editor options
│ │ ├── keymaps.lua -- 752 lines of keymaps
│ │ └── autocmds.lua -- Autocommands
│ ├── plugins/ -- 30 plugin spec files
│ │ ├── ai-code.lua -- OpenCode.nvim integration
│ │ ├── alpha-nvim.lua -- Dashboard (disabled — Snacks handles it)
│ │ ├── blink.lua -- Blink.cmp completion (v2.x)
│ │ ├── conform.lua -- Formatting (stylua, prettier, markdownlint)
│ │ ├── fzf-lua.lua -- Disabled (Snacks picker replaces it)
│ │ ├── git-nvim.lua -- Fugitive + gitsigns
│ │ ├── hipatterns.lua -- Mini.hipatterns (Tailwind CSS colors)
│ │ ├── lualine.lua -- Custom statusline
│ │ ├── luasnip.lua -- Snippets (friendly-snippets + custom markdown)
│ │ ├── markdown.lua -- Markdown preview, render, TOC, folding
│ │ ├── mason.lua -- LSP/formatter/linter installer
│ │ ├── mini-surround.lua -- Mini.surround (gsa/gsd/gsf/gsr)
│ │ ├── multicursor.lua -- Multicursors
│ │ ├── navic.lua -- Navic code context
│ │ ├── noice.lua -- Noice UI (cmdline popup, notifications)
│ │ ├── none-ls.lua -- None-ls (eslint diagnostics)
│ │ ├── nvim-dap.lua -- DAP (JS/TS debugging)
│ │ ├── obsidian.lua -- Obsidian.nvim vault integration
│ │ ├── snacks.lua -- Snacks.nvim (picker, dashboard, image rendering)
│ │ ├── snips.lua -- nvim-cmp config (disabled — Blink wins)
│ │ ├── sticky.lua -- Fusen.nvim sticky annotations
│ │ ├── telescope.lua -- Telescope (disabled — Snacks picker)
│ │ ├── terminal.lua -- Terminal integration
│ │ ├── themes.lua -- Catppuccin (macchiato, transparent)
│ │ ├── treesitter.lua -- Treesitter (28 parsers, textobjects)
│ │ ├── ts-comments.lua -- Treesitter-based commenting
│ │ └── ui.lua -- Bufferline, colorful-menu, etc.
│ └── utilities/ -- Helper Lua modules
│ ├── discipline.lua -- Repeated-keys nag
│ ├── lsp_utils.lua -- LSP helpers
│ ├── markdown_utils.lua -- Markdown folding engine
│ ├── obsidian_utils.lua -- Cross-platform Obsidian vault paths
│ ├── odn.lua -- Obsidian daily note integration
│ └── utils.lua -- General utilities
Picker: Snacks.nvim (replaces Telescope + fzf-lua + alpha-nvim)
- Vertical layout (85%w x 95%h, preview top, list bottom)
- Keymaps:
<leader>ff (files), <leader>fg (grep), <leader>fb (buffers), etc.
- Dashboard with ASCII art, GitHub notifications, issues/PRs panels, git status widget
- Image rendering (png, jpg, gif, bmp, webp, pdf) with Obsidian vault path resolution
- LazyGit integration via
<leader>glg
Completion: Blink.cmp (v2.x)
- Sources: lazydev, lsp, path, snippets, buffer
- Snippets triggered by
; prefix
- Fuzzy implementation:
"lua" (avoids .dll issues on Windows)
- Ghost text, signature help, cmdline completion
LSP (via mason.nvim v2)
Installed servers: astro, bashls, cssls, eslint, graphql, html, jsonls, lua_ls,
powershell_es, prismals, sqlls, ts_ls, vimls, lemminx, yamlls, omnisharp
Key customizations:
- omnisharp: Full Roslyn analyzers, decompilation, editorconfig, cross-platform .NET SDK detection
- lua_ls: LazyVim library paths, inlay hints (param names, array indices)
- ts_ls: Inlay hints (param names, function types, variable types)
- jsonls: Custom schemas for Sitecore config files (sitecore.json, *.module.json)
- powershell_es: Mason-managed PowerShell Editor Services
- marksman: Only loaded outside Obsidian vaults
Formatting (conform.nvim)
stylua → Lua, prettier → JS/TS/CSS/SCSS/JSON/YAML- Markdown:
prettier + markdownlint-cli2 + markdown-toc (conditional)
- Linting:
eslint_d via nvim-lint for JS/TS on write/save
- Keymap:
<leader>ccf
Treesitter
28 parsers installed (astro, bash, css, c_sharp, razor, go, graphql, html, http,
javascript, json, json5, lua, markdown, markdown_inline, powershell, prisma, regex,
scss, sql, tsx, typescript, vim, vimdoc, xml, yaml, git-related)
Textobjects: af/if (function), ac/ic (class)
Markdown Power-User Setup
- render-markdown.nvim: Heading icons (6 levels), borders, code block styling,
auto-strikethrough for
[x] checkboxes, custom H1-H6 background colors
- markdown-preview.nvim: Browser preview (
<leader>mrt)
- markdown-toc.nvim: Dual TOC formats — browser-compatible (
<leader>motoC)
and Obsidian wikilinks (<leader>motoc)
- Custom folding: Treesitter-based markdown folding by heading level
(
zj/zk/zl/z; for fold levels, zu to unfold all)
- Snippets: Markdown code blocks, link templates, TODO items, JSDoc, callouts
Obsidian Integration
Full vault workflow via obsidian.nvim:
- Workspaces:
ObsidianWork and ObsidianWorkArchive
- Custom frontmatter: id, aliases, tags, date, links, target_folder, target_subfolder, urls
- Note ID format:
YYYY-MM-DD-title
- Picker: Snacks
- Footer with backlinks/properties/words/chars
- Cross-platform vault path detection (macOS/Windows)
Keymaps (notable)
| Keymap | Action |
|---|
<leader>ff | Find files (Snacks) |
<leader>fg | Live grep |
<leader>fb | Buffers |
K | LSP hover |
gd / gr | LSP definition / references |
<leader>rn | Incremental rename |
<leader>ccf | Format file |
<leader>glg | Open LazyGit |
<leader>motoC | Insert browser TOC |
<leader>motoc | Insert Obsidian TOC |
<leader>oin | Insert notes template |
<leader>oit | Insert todo template |
<leader>oBl | Show backlinks |
<leader>ok | Move file to zettelkasten |
<leader>oa | OpenCode ask with @this |
<leader>os | OpenCode select |
JavaScript/TypeScript Debugging (nvim-dap)
- Supports: pwa-node (launch file), pwa-chrome, pwa-msedge (with URL prompt)
- DAP UI auto-opens on attach/launch, closes on terminate
AI Coding: OpenCode.nvim
- Keymaps:
<leader>oa (ask with @this), <leader>os (select),
go (operator), goo (line), S-C-u/S-C-d (scroll)
