hover.nvim
Rest the cursor on something that points at a file — a markdown link, or a path written as plain text — and a small float shows what it points at.
- 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
- Files & navigation
- neovim
- 0.11+
- repo
- github.com/WKDSteve/hover.nvim
- commits
- 268
- help
- :help hover
demo
demos/hover.tape in a clean Neovim — re-recorded weekly
what is shown when
- :Hover show on a markdown link -> markdown.nvim finds the target -> the file, previewed in place
- :Hover show on a bare path in prose -> resolved next to the buffer -> previewed the same way
- :Hover show on file.md#heading -> that section of the file, not its top
- :Hover show on https://wkdsteve.github.io/wkd/ -> curl fetches the page -> status, title, first words
demos/hover-media.tape in a clean Neovim — re-recorded weekly
· needs media.nvim
, pdfport.nvim
What the float can hold depends on the terminal: with a graphics protocol (kitty, sixel) it draws a frame of the video and page 1 of the PDF; this recording runs in one without, so it shows what hover.nvim says instead. what is shown when
- :Hover show on an mp4 link -> media.nvim probes it with ffprobe -> type, size, resolution, length
- :Hover show on a PDF link -> pdfport.nvim renders page 1 in a graphics terminal -> here: what the float says
- :Hover why on plain prose -> the gate that refused, and what would let it through
screenshots
install
{
"WKDSteve/hover.nvim",
opts = {},
} docs/
- BINDINGS.md
- CONTRIBUTING.md
- NAME-COLLISION.md
- README.md
- WORKFLOW-LOGIN-PAGES.md
- WORKFLOW.md
- api.md
- architecture.md
- commands.md
- configuration.md
- health.md
- installation.md
- integrations.md
- quickstart.md
- scope.md
- what-you-get.md
git log
- fix directory: a one-row float shows the count alone; a cut sub-folder count keeps the floor
- test sheets: the http live sheet names no variable
- fix directory: the '… N more' line of a cut listing is on screen
- fix scroll: a file:42 hover scrolls on from the line it opened at
- fix text: scrolling back skips no line, a range as long as the page keeps its last line
- fix text: the … of a cut text page is on screen
- feat registry: chain several previews for one target type
- test sheets: :Hover images off and on, on the picture of the zoom sheet
- test sheets: what six :Hover switches do, by the trigger and :Hover why
- fix float: build each page as tall as the window beside the cursor
- ci check fileops.nvim out at ci-verified instead of a pinned commit
- fix float: never cover the cursor line on a small screen