Notelets

Add sticky notes for your code — Markdown files alongside your project, organized by path.

Notelets

Features

Add a note for any non-Markdown file with a single command or click.
Notes are plain Markdown files stored under a configurable folder (defaults to .vscode/notelets/) mirroring your project structure.
Fast, minimal, zero distractions:
- CodeLens at the top of source files: "Add Note" / "Open Note".
- Optional status bar indicator showing if a note exists.
- Possibility to browse all notes in the workspace.
Smart behavior:
- Renaming a file renames its note.
- Deleting a file deletes its note.
- No notes for Markdown files or notes themselves (by design).
Almost zero config; sensible defaults.

Notelets with a tree view

Notelets status bar icon

I wanted a coherent workflow where lightweight documentation lives with the code it describes using the familiar convenience of Markdown:

Notes are plain Markdown inside your repo, version‑controlled with your code and reviewable.
The folder mirrors your project structure, so a note naturally “belongs” to a file and travels with it on rename/move.
No proprietary storage, no external sync, and works offline on any machine.
Collaboration is simple: commit, push, review, and share with the team like any other code change.
Minimal UI and zero lock‑in by design.

[!TIP] To exclude notelets from version control, add notelets.notesFolder setting value to your .gitignore:
.vscode/notelets/

Notelets commands

You can run these commands from the Command Palette (Cmd+Shift+P on a Mac, or Ctrl+Shift+P on Windows).

Description	Name	Default Mac	Default Windows
Open or create a note	`notelets.openNote`	—	—
Focus on notes view		—	—

[!TIP] Bind a key to notelets.openNote for even faster access.

You can change the following options in the Visual Studio Code settings.

Description	Setting	Default
Relative path to the root folder where Notelets are stored	notelets.notesFolder	`.vscode/notelets`
How to open notes: editor or Markdown preview	notelets.openBehavior	`editor`
Show a status bar item when a file has a Notelet	notelets.showStatusBar	`true`

For a file like src/utils/math.ts, its note will be created (by default) at:
- .vscode/notelets/src/utils/math.ts.md
Notes follow file renames and moves, and are removed when the source file is deleted.
Notes are not created for Markdown files or for note files themselves.