Image Preview¶
timvim can render images directly in the editor using image.nvim and the Kitty graphics protocol. When the cursor sits on an image path in a markdown file, a popup preview appears — ideal for reviewing screenshots and diagrams inline.
Controls¶
| Key | Mode | Action |
|---|---|---|
<leader>tI |
n | Toggle image preview on/off (global) |
<leader>ic |
n | Clear all rendered images in the buffer |
Clearing quickly
In markdown files, pressing Esc also clears rendered images along with any
search highlight.
Requirements¶
Image preview relies on a terminal that speaks the Kitty graphics protocol:
Terminal support
If images do not appear, your terminal probably lacks Kitty graphics support. Preview is disabled gracefully in that case — the rest of timvim works normally.
Where it triggers
Previews are shown for image paths inside markdown buffers. Move the cursor
onto a path such as  to see it render, and use
<leader>ic to clear the display when you are done.