Smart Bookmarks
✨ Mark lines of code with notes, categories, and colors. Navigate, search, and export your bookmarks with an intelligent sidebar panel.
Features
🔖 Intelligent Bookmarks
- Toggle bookmarks on any line with a single shortcut
- 5 built-in categories: TODO, BUG, REVIEW, NOTE, IMPORTANT
- Each category has its own color and icon
📝 Notes & Labels
- Add custom notes to any bookmark
- Set custom labels for quick identification
- Notes appear inline in the editor and in the sidebar
- Dedicated activity bar icon with a bookmark panel
- Group bookmarks by file or by category
- Click any bookmark to navigate instantly
- Right-click for quick actions (edit, delete, change category)
🎨 Visual Indicators
- Gutter icons colored by category
- Subtle line highlights on bookmarked lines
- Inline labels showing category and notes
- Overview ruler marks for quick scrolling reference
🔍 Search & Navigate
- Quick search across all bookmarks by name, file, or note
- Next/Previous navigation to jump between bookmarks
- Status bar showing total bookmark count
📄 Export
- Export to Markdown with a formatted table of all bookmarks grouped by file
💾 Persistent Storage
- Bookmarks are saved in
.vscode/smart-bookmarks.json
- Survives restarts — your bookmarks are always there
- Line tracking — bookmark positions auto-adjust when you edit code
Keyboard Shortcuts
| Shortcut (Mac) |
Shortcut (Win/Linux) |
Action |
⌘+⌥+B |
Ctrl+Alt+B |
Toggle bookmark |
⌘+⌥+⇧+B |
Ctrl+Alt+Shift+B |
Toggle bookmark with category |
⌘+⌥+] |
Ctrl+Alt+] |
Next bookmark |
⌘+⌥+[ |
Ctrl+Alt+[ |
Previous bookmark |
⌘+⌥+F |
Ctrl+Alt+F |
Search bookmarks |
Categories
| Category |
Color |
Use Case |
| TODO |
🔵 Blue |
Tasks to complete |
| BUG |
🔴 Red |
Bug locations |
| REVIEW |
🟠 Orange |
Code to review |
| NOTE |
🟢 Green |
General annotations |
| IMPORTANT |
🟣 Purple |
Critical sections |
Extension Settings
| Setting |
Default |
Description |
smartBookmarks.defaultCategory |
note |
Default category when toggling |
smartBookmarks.groupBy |
file |
Group by file or category |
smartBookmarks.showLineHighlight |
true |
Show line background highlight |
smartBookmarks.showGutterIcon |
true |
Show gutter icons |
Commands
Open the Command Palette (⌘+⇧+P / Ctrl+Shift+P) and type "Smart Bookmarks":
- Toggle Bookmark — Add/remove bookmark on current line
- Toggle Bookmark with Category — Add bookmark with category selection
- Edit Note — Add or edit a note on a bookmark
- Edit Label — Set a custom label
- Change Category — Change bookmark category
- Next/Previous Bookmark — Navigate between bookmarks
- Search Bookmarks — Search across all bookmarks
- Export to Markdown — Export all bookmarks as a Markdown file
- Clear All Bookmarks — Remove all bookmarks
- Toggle Group By — Switch between file and category grouping
License
MIT
| |
