Filemarks

Numbered bookmarks with folder organization for VS Code

Filemarks is a powerful bookmark extension that lets you quickly navigate your code using numbered shortcuts (0-9) with visual gutter icons and organize bookmarks into folders.

Features

🔢 Numbered Bookmarks (0-9)

Quickly set and jump to up to 10 bookmarks per file using keyboard shortcuts.

🔖 Visual Gutter Icons

• Bookmark-shaped icons with numbers displayed in the editor gutter
• Customizable colors (default: yellow/gold background, brown number)
• Instantly see which lines are bookmarked

🔍 Search & Filter

• Real-time fuzzy search across all bookmarks
• Filter by bookmark name or file path
• Search results update as you type
• Visual indicator when filter is active

📁 Folder Organization

• Create folders to organize your bookmarks
• Drag and drop bookmarks between folders
• Drop bookmark onto another bookmark to move to same folder
• Hierarchical structure for complex projects
• Create subFolders within folders (right-click folder)

🎛️ Sidebar Controls

Quick access buttons in the sidebar title bar:

📂 File Icons

• Sidebar displays consistent file icons for all bookmarks
• Easily identify bookmarked files at a glance
• Drag bookmarks to editor area to open files
• Right-click files in Explorer to add bookmarks

🔄 Smart Features

🌍 Internationalization

• English
• Korean (한국어)

Installation

1. Open VS Code
2. Press Ctrl+P / Cmd+P
3. Type ext install nicegyuha.filemarks
4. Press Enter

Quick Start

1. Set a bookmark: Place cursor on a line, press Ctrl+Alt+1
2. Auto bookmark: Press Ctrl+Alt+P to auto-assign next available number
3. Jump to bookmark: Press Ctrl+1 to jump back
4. Navigate bookmarks: Press Ctrl+Alt+] for next, Ctrl+Alt+[ for previous
5. Search bookmarks: Click the search icon in sidebar to filter bookmarks
6. Focus sidebar: Press Ctrl+Shift+B to focus the Filemarks sidebar
7. Organize: Drag and drop bookmarks into folders, or right-click → "Move to Folder"
8. Add from Explorer: Right-click any file in Explorer → "Add Bookmark"

Commands

Configuration

Custom Colors Example

{
  "filemarks.gutterIconFillColor": "#3498DB",
  "filemarks.gutterIconNumberColor": "#FFFFFF"
}

Storage

Bookmarks are stored based on the filemarks.saveBookmarksInProject setting:

Project Storage (default: saveBookmarksInProject: true)

Bookmarks are saved in your project folder:

{workspace}/.vscode/filemarks.json

• ✅ Share with team via version control
• ✅ Project-specific bookmarks
• ✅ Automatic backup with project

Global Storage (saveBookmarksInProject: false)

Bookmarks are saved in VS Code's global storage with a per-workspace file name that includes the folder name and a path hash:

filemarks-{folderName}-{hash6}.json

• ✅ Bookmarks persist across all workspaces
• ✅ Not tracked in version control
• ✅ Personal bookmarks that don't affect team members
• 🔄 Existing global filemarks.json is automatically migrated to the new per-workspace file name

Sidebar View

Access the Filemarks view from the Activity Bar:

• 🔍 Search and filter bookmarks in real-time
• 📁 Hierarchical folder structure with file-type icons
• 🖱️ Click to jump to bookmark
• 🔀 Drag & drop to organize (onto folders or other bookmarks)
• 📂 Drag to editor area to open file
• 📋 Right-click for context menu
• ➕ Add bookmarks directly from Explorer context menu

Keyboard Shortcuts Summary

Windows / Linux

macOS

Requirements

• VS Code 1.85.0 or higher

Release Notes

See CHANGELOG.md for version history.

Issues & Feedback

Found a bug or have a suggestion? Open an issue

License

MIT

Made with ❤️ by Gyuha