Problems I routinely ran into:
- Adding TODO comments everywhere during reviews/debugging/etc and then forgetting where they are
- Linking handwritten notes/logs to files
- Jumping between multiple files during debugging and losing track of important spots
- Context-switching costs when working on a feature and needing to shift to a critical bug in prod
- Needing to quickly understand project scope and code created by a developer who left the team mid-project
Enter marker-groups.nvim:
- TLDR; bookmarks, but with rich annotations, visual indicators, and smart organization.
Key Features:
Smart markers – Single-line or multi-line with rich annotations
Groups – Organize markers by feature, bug, review, etc.
Visual indicators – See markers right in your code with virtual text
Drawer viewer – Browse all markers with file context in a side panel
Telescope integration – Fuzzy search through all your markers
Persistent – Markers survive restarts and are saved automatically
Real-world usage examples:
Code Reviews:
- Group all review comments together instead of scattering TODO comments throughout your code
- Add contextual annotations like "CONCERN: This could cause memory leaks"
- Quickly jump between review points without losing your place
Feature Development:
- Create a group per feature branch to track implementation progress
- Mark areas that need refactoring or optimization
- Keep implementation notes organized and accessible
Debugging:
- Group markers by investigation theme (e.g., "memory-leak-investigation")
- Annotate suspicious code patterns with detailed context
- Track reproduction steps and potential fixes
I hope you find this plugin a helpful addition to your existing workflow. Feel free to open issues and ask questions on Github or this post. Thanks for checking it out!
Enter marker-groups.nvim: - TLDR; bookmarks, but with rich annotations, visual indicators, and smart organization.
Key Features: Smart markers – Single-line or multi-line with rich annotations Groups – Organize markers by feature, bug, review, etc. Visual indicators – See markers right in your code with virtual text Drawer viewer – Browse all markers with file context in a side panel Telescope integration – Fuzzy search through all your markers Persistent – Markers survive restarts and are saved automatically
Real-world usage examples:
Code Reviews: - Group all review comments together instead of scattering TODO comments throughout your code - Add contextual annotations like "CONCERN: This could cause memory leaks" - Quickly jump between review points without losing your place
Feature Development: - Create a group per feature branch to track implementation progress - Mark areas that need refactoring or optimization - Keep implementation notes organized and accessible
Debugging: - Group markers by investigation theme (e.g., "memory-leak-investigation") - Annotate suspicious code patterns with detailed context - Track reproduction steps and potential fixes
Difference from existing solutions:
I had a hard time finding a comparable plugin. https://github.com/winter-again/annotate.nvim was the closest I could find, but the repo has been archived for over a year. https://github.com/chentoast/marks.nvim is awesome at what it does, but it isn't focused on being a note-taking tool.
I hope you find this plugin a helpful addition to your existing workflow. Feel free to open issues and ask questions on Github or this post. Thanks for checking it out!