NORMAL ~/wkd/p/images :set skin=modern utf-8

images.nvim

images.nvim shows images in the terminal without leaving Neovim: hover a markdown link, double-click it, or paste a screenshot straight from the clipboard into the document. It draws through the iTerm2 inline-image protocol (OSC 1337) instead of the Kitty graphics protocol the alternatives rely on, which is what makes it work on native Windows Neovim in WezTerm, where they do not.

status
beta — Beta stage — active development. This repository is past its first shape and in active use, but the surface is not frozen: breaking changes are still possible. Pin a commit or tag if you depend on it.
category
View & render
neovim
0.10+
repo
github.com/StefanBartl/images.nvim
commits
205
help
:help images

install

{
  "StefanBartl/images.nvim",
  opts = {},
}

docs/

git log

  1. fix paste: env roots fold case only on Windows; no cursor/insert in a window that switched buffers
  2. feat paste: env link mode, mode words, cursor lands in the link
  3. refactor paste: drive paste_with_name via lib.nvim.async instead of nested callbacks
  4. fix paste: move_file is now truly atomic, preserves permissions, handle_response pcalls callbacks
  5. fix paste: M.replace writes via tempname, fail_all pcalls user callbacks
  6. fix paste: win_clipboard_worker.shutdown() now answers requests still in flight
  7. feat paste: windows_persistent_helper opt-out + fix a file-deletion bug on M.replace failure
  8. perf paste: keep one persistent PowerShell process for Windows clipboard reads
  9. feat menu: integrations.ui_menu switch + enabled() for ui.nvim's right-click menu
  10. docs repair CASE/ANCHOR link mismatches via docs_linkcheck.py --fix
  11. docs link back to the wkd family site
  12. feat paste: add path=relative|absolute|repos|<prefix> to :Image paste

keys

j / k
next / previous line
gg / G
first / last line
⏎
open the line under the cursor
/
search the plugins
:
command line — Tab completes
:help x
vimdoc of a plugin (:e x = plugin page)
:ls · :log · :stack
plugin list · activity stream · dependency graph
:colo x
colorscheme
:set skin=
modern | tui
?
this help
esc
close