A notes panel that lives in the Activity Bar. Jot quick notes, to-dos, and scratch
text without leaving your editor — and keep them in a folder outside your
projects, so notes never end up tracked in a work repository.
One panel shows your list of notes; click a note to edit it right there in the same
panel. Notes are plain .md and .txt files in a folder you choose, so they're
yours to read, sync, or back up however you like.
Features
- Notes in the sidebar — a dedicated Activity Bar view with a list of your notes,
sorted by most recently edited.
- Edit in place — click a note to switch the panel to an editor; click ← to go
back to the list. No extra tabs or windows needed.
- Autosave — edits save automatically as you type (debounce is configurable), and
always flush when you switch notes or hide the panel, so nothing is lost.
- Markdown & plain text — create notes as
.md or .txt; the list shows both.
- Open in a full editor tab — one click opens the note as a normal file, with
native Markdown preview for
.md.
- Stays out of your repos — notes live in a folder of your choosing, outside any
workspace, so there's nothing to gitignore.
- Follows your theme — the panel uses your VS Code colors and editor font.
- Picks up external changes — edit a note file outside the editor and the panel
refreshes; your unsaved edits in the panel are never clobbered.
Getting started
- Open the Side Notes view from the Activity Bar (the note icon).
- If your notes folder doesn't exist yet, click Create folder.
- Click ➕ to create your first note, give it a name, and start typing.
By default notes are stored in ~/Notes. Change this any time in Settings (see below).
Settings
| Setting |
Default |
Description |
sideNotes.notesFolder |
~/Notes |
Folder where note files are stored. ~ expands to your home directory. Kept outside any project by design. Created on demand. |
sideNotes.defaultFormat |
md |
File extension used for newly created notes (md or txt). The list always shows both formats. |
sideNotes.autoSaveDelayMs |
750 |
How long to wait (in milliseconds) after you stop typing before a note autosaves. Minimum 200. |
The ⚙ button in the panel header opens these settings directly.
Commands
- Side Notes: New Note (
sideNotes.newNote)
- Side Notes: Refresh (
sideNotes.refresh)
- Side Notes: Reveal Notes Folder (
sideNotes.openNotesFolder)
Notes are just files
Every note is a real .md or .txt file in your notes folder. That means you can:
- back them up, sync them with any cloud folder, or keep them in their own git repo;
- open and edit them with any other tool;
- delete from the panel (deletes go to the trash, so they're recoverable).
Privacy
Side Notes works entirely on your machine. It reads and writes files only in the
notes folder you configure. It makes no network requests and collects no telemetry.
License
Released under the MIT License.
