Transform how you navigate and understand code
Lightning-fast code highlighting with comments, team collaboration, and intelligent persistence
Quick Start β’ Features β’ Demos β’ Usage β’ Shortcuts
Stop losing track of important code sections. Whether you're:
- Code reviewing - Mark sections for feedback and discussion
- Debugging - Track problem areas across multiple files
- Learning - Annotate unfamiliar code with notes
- Refactoring - Identify sections that need attention
- Collaborating - Share annotated code with your team
Highlightability keeps your focus where it matters most.
Get highlighting in 3 seconds:
- Install the extension from the VS Code Marketplace
- Select any code
- Press
Ctrl+Shift+Z(Mac:Cmd+Shift+Z)
That's it! Your code is highlighted. Press the same shortcut to remove it.
- One-click toggle -
Ctrl+Shift+Zto highlight/unhighlight instantly - 5 color options - Yellow, Green, Pink, Cyan, Orange for categorization
- Zero friction - No dialogs, no prompts, just highlight
- Attach comments to any highlight (hover to view)
- Edit anytime - Update comments without recreating highlights
- Persistent notes - Your annotations survive edits and restarts
- Auto-adjusting ranges - Highlights track code as you edit
- Workspace persistence - Highlights survive VS Code restarts
- Multi-file support - Manage highlights across your entire project
- Export/Import - Share highlighted code reviews via JSON
- Merge or replace - Flexible import options for team workflows
- Version control friendly - Keep highlights in sync with your codebase
- Tree View sidebar - See all highlights at a glance, organized by file
- Quick navigation - Jump to any highlight from sidebar or command palette
- Batch operations - Clear highlights per file or across all files
- Comprehensive logging - Debug issues with detailed output
| Shortcut | Action | Description |
|---|---|---|
Ctrl+Shift+Z(Mac: Cmd+Shift+Z) |
Toggle Highlight | Add or remove highlight on selected text |
Ctrl+Shift+C(Mac: Cmd+Shift+C) |
Edit Comment | Edit comment for highlight at cursor |
Pro tip: Use the toggle shortcut for instant highlighting with your default color. For specific colors, use the right-click context menu.
The fastest way to highlight code:
- Select text in your editor
- Press
Ctrl+Shift+Z(Mac:Cmd+Shift+Z) - Done! Text is highlighted with your default color
Press again to remove the highlight. No dialogs, no friction.
Need to categorize with colors?
- Select text
- Right-click β Highlightability β Highlight Color
- Choose: Yellow, Green, Pink, Cyan, or Orange
Each selection can only have one highlight at a time.
Turn highlights into smart annotations:
Add a comment:
- Right-click highlighted text β Edit Comment
- Or use
Ctrl+Shift+C(Mac:Cmd+Shift+C)
View comments:
- Hover over any highlight to see its comment
Edit from sidebar:
- Click the pencil icon next to any highlight in the Tree View
Access the Highlights sidebar (bookmark icon in Activity Bar):
- Browse all highlights organized by file
- Click any highlight to jump to its location
- Edit comments with the pencil icon
- Delete highlights with the trash icon
- Export/Import using the toolbar buttons
Share highlights with your team:
Export:
- Click export icon in Tree View toolbar
- Save JSON file to share
Import:
- Click import icon in Tree View toolbar
- Select JSON file
- Choose to merge (add to existing) or replace (clear all first)
Perfect for code reviews and onboarding!
Remove highlights quickly:
- Single highlight: Right-click β Remove Highlight
- All in file: Command Palette β Clear All Highlights β Current File
- All in workspace: Tree View clear icon or Command Palette β All Files
See highlighting in action - one keyboard shortcut to rule them all.
https://github.com/user-attachments/assets/your-video-id-here
Choose colors to categorize and add notes to stay organized.
https://github.com/user-attachments/assets/your-video-id-here
Manage all highlights from one place and share with your team.
https://github.com/user-attachments/assets/your-video-id-here
Highlights that intelligently track your code as you edit.
https://github.com/user-attachments/assets/your-video-id-here
Click to expand full command list
Access these via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
Highlighting:
Toggle Highlight- Add/remove highlight on selected textYellow/Green/Pink/Cyan/Orange- Color-specific highlights
Comments:
Edit Comment- Add or edit comment on highlight
Navigation:
List All Highlights- Quick pick menu to jump to any highlightJump to Highlight- Navigate to specific highlight
Management:
Clear All Highlights- Remove highlights from current file or all filesRefresh Highlights- Reload Tree ViewExport Highlights- Save to JSONImport Highlights- Load from JSON
Debugging:
Show Highlighter Logs- View extension output logs
Customize colors and defaults in your VS Code settings:
{
"codeHighlighter.defaultColor": "#FFFF0066",
"codeHighlighter.colors": [
"#FFFF0066", // Yellow
"#00FF0066", // Green
"#FF00FF66", // Pink
"#00FFFF66", // Cyan
"#FFA50066" // Orange
]
}Settings:
codeHighlighter.defaultColor- Color used by toggle shortcut (RGBA hex)codeHighlighter.colors- Available colors in the color picker menu
Click for troubleshooting guide
Command Palette β Show Highlighter Logs to see detailed debug information.
Highlights not visible:
- Verify the correct file is open
- Check logs for decoration application status
- Try refreshing the Tree View
Highlights disappeared after editing:
- Extension auto-adjusts ranges - check logs if issues persist
- Try reloading the window (
Ctrl+Shift+PβReload Window)
Extension not loading:
- Check logs for activation errors
- Ensure VS Code version is 1.80.0 or higher
Import not working:
- Verify JSON file format is valid
- Check file paths in JSON match your workspace structure
If issues persist, open an issue with your logs attached.
Click for development setup
# Clone the repository
git clone https://github.com/housamkak/highlightability.git
cd highlightability
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# Open in VS Code and press F5 to launch Extension Development Host| Command | Description |
|---|---|
npm install |
Install dependencies |
npm run compile |
Compile TypeScript to JavaScript |
npm run watch |
Watch mode for active development |
npm run lint |
Run ESLint for code quality |
npm run package |
Create .vsix package for distribution |
highlightability/
βββ src/
β βββ extension.ts # Main extension entry point
β βββ highlightManager.ts # Core highlighting logic
β βββ treeViewProvider.ts # Sidebar Tree View
βββ assets/
β βββ logo/ # Extension logos and icons
βββ out/ # Compiled JavaScript output
βββ package.json # Extension manifest
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Copyright Β© 2025 Housam Kak. All Rights Reserved.
This software is proprietary and confidential. Unauthorized copying, distribution, modification, or use is strictly prohibited without express written permission.
Licensing inquiries: housam.kak20@gmail.com
Found a bug or have a feature idea? Open an issue on GitHub
We track:
- Bug reports
- Feature requests
- Performance issues
- Documentation improvements
Love Highlightability?
- β Star us on GitHub
- π Leave a review on VS Code Marketplace
- π¦ Share with your fellow developers
- π‘ Submit feature ideas and feedback
Need Help?
- Check the Troubleshooting section
- Browse existing issues
- Open a new issue with the
questionlabel
Upcoming features we're considering:
- Custom color palettes
- Highlight groups/categories
- Search/filter highlights
- Cloud sync for highlights
- Markdown export for documentation
- Code snippet generation from highlights
Have an idea? Let us know!
Made with β€οΈ for developers who love organized code
Built by Housam Kak