Bookmarks with Notes

A powerful VS Code extension for bookmarking lines with notes, labels, and categories. Organize your codebase, add annotations to important lines, and navigate your code efficiently.

Features

• Bookmark Lines - Quickly bookmark any line in your code
• Add Notes - Annotate bookmarks with descriptions explaining why they're important
• Labels & Categories - Organize bookmarks with built-in labels: Bug, Todo, Important, Review, Temp
• Sidebar Panel - View all bookmarks grouped by file in the Explorer sidebar
• Quick Navigation - Jump to any bookmark with fuzzy search
• Persistence - Bookmarks are saved per workspace and survive VS Code restarts
• Line Tracking - Bookmarks automatically update when you add/remove lines
• Gutter Icons - Visual indicators in the editor gutter for each bookmark type
• Line Highlighting - Subtle background color on bookmarked lines

Keyboard Shortcuts

Commands

All commands are available via the Command Palette (Cmd/Ctrl+Shift+P):

• Bookmarks: Toggle Bookmark - Add or remove a bookmark at the current line
• Bookmarks: Toggle Bookmark with Note - Add a bookmark with a note prompt
• Bookmarks: Go to Bookmark - Open quick pick to navigate to any bookmark
• Bookmarks: Edit Note - Edit the note for the bookmark at current line
• Bookmarks: Set Label - Change the label/category of a bookmark
• Bookmarks: Next Bookmark in File - Jump to the next bookmark
• Bookmarks: Previous Bookmark in File - Jump to the previous bookmark
• Bookmarks: Clear All in Current File - Remove all bookmarks in the current file
• Bookmarks: Clear All Bookmarks - Remove all bookmarks in the workspace
• Bookmarks: Filter by Label - Show only bookmarks with a specific label
• Bookmarks: Export to JSON - Export bookmarks to a file
• Bookmarks: Import from JSON - Import bookmarks from a file

Label Types

Settings

Custom Labels Example

{
  "bookmarksWithNotes.customLabels": [
    { "name": "security", "icon": "lock", "color": "#ff6b6b" },
    { "name": "performance", "icon": "zap", "color": "#ffd93d" }
  ]
}

Storage

Bookmarks are stored in .vscode/bookmarks.json within your workspace. This file can be committed to version control to share bookmarks with your team.

Why Bookmarks with Notes?

Unlike basic bookmark extensions, Bookmarks with Notes lets you:

1. Remember context - Add notes explaining why a line is bookmarked
2. Categorize - Use labels to organize bookmarks by purpose
3. Search - Find bookmarks by note content or code snippet
4. Share - Export/import bookmarks or commit them to your repo

License

MIT