marks.nvim
A Neovim plugin that enhances Vim marks with visual signs, quick navigation, and bookmark management.
What is marks.nvim?
marks.nvim is a Neovim plugin that enhances the built-in Vim marks system with visual indicators, easier navigation, and bookmarking capabilities. It solves the problem of invisible and cumbersome mark management by providing signs in the gutter, quick keybindings, and tools to organize positions across buffers.
Neovim users (0.5+) who frequently use Vim marks for navigation and want a more visual and efficient workflow.
It offers a modern, feature-rich alternative to traditional mark plugins with better performance, customizable bookmark groups, and seamless integration into Neovim's Lua ecosystem.
Overview
A better user experience for viewing and interacting with Vim marks.
Use Cases
Best For
- Visualizing mark locations in the sign column
- Quickly jumping between marks in large files
- Organizing code positions with customizable bookmarks
- Extracting marks to location lists for refactoring
- Navigating across multiple buffers using bookmarks
- Enhancing Vim mark workflows with minimal configuration
Not Ideal For
- Vim users who haven't migrated to Neovim 0.5 or later
- Developers who prefer plugins with zero configuration and minimal keybinding changes
- Users editing massive files where the sign refresh interval could introduce noticeable lag
Pros & Cons
Pros
Displays marks in the sign column for immediate visibility, eliminating the need to remember mark positions, as shown in the demo GIF.
Supports up to 10 bookmark groups with custom signs and virtual text annotations, enabling organized navigation across multiple buffers.
Provides intuitive default mappings for adding, deleting, and cycling marks, streamlining common operations without memorization.
Can export marks to quickfix or location lists for batch actions, facilitating tasks like refactoring or code review.
Cons
Lacks operator pending and count-aware movement mappings, which are standard in Vim mark workflows, as acknowledged in the Todos section.
Requires manual tuning of refresh_interval to balance visual feedback and performance, which can be cumbersome and lead to lag if misconfigured.
Setup involves Lua configuration and potential keybinding conflicts, making it less plug-and-play for users who prefer minimal setup.
Frequently Asked Questions
Related Projects
harpoonHarpoon is a Neovim plugin designed to solve the repetitive navigation problem in software development. It allows users to mark frequently accessed files and terminals within a project, providing quick keyboard-driven access to reduce context switching and boost productivity. ## Key Features - **Persistent File Marks** — Mark important files per-project with positions that auto-update as you edit. - **Quick Navigation Menu** — Toggle a menu to view, reorder, or jump to marked files instantly. - **Terminal Management** — Create, navigate between, and send commands to multiple persistent terminal sessions. - **Tmux Integration** — Seamlessly control tmux windows and panes directly from Neovim. - **Telescope Extension** — Browse and select marks using the popular Telescope fuzzy finder. - **Customizable Configuration** — Adjust settings like save behavior, excluded filetypes, and menu appearance. ## Philosophy Harpoon emphasizes minimal keystrokes and persistent, project-aware navigation, treating files and terminals as equally important resources in a developer's workflow.
arrow.nvimBookmark your files, separated by project, and quickly navigate through them.
grapple.nvimNeovim plugin for tagging important files
bookmarks.nvimPersistent bookmarks: hard disk of your thoughts
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.