NotesVS 📝
NotesVS is the ultimate tool for managing your notes and calendar directly within VS Code, without interruptions and seamlessly integrated into your workflow.
Developed with ❤️ by mariorodrigueeez.
✨ Features
- Notes Explorer — Manage
.md notes and folders just like the native file explorer, with drag & drop support.
- Pending Tasks view — All
- [ ] checkboxes across your notes are aggregated in one place. Check them off without opening the file.
- Integrated Calendar — Visualize your days and open daily notes with a single click. Days that already have a note show a blue dot.
- Wiki-links — Type
[[Note Name]] anywhere in a markdown file to create a clickable link to another note.
- Note search — Fuzzy-search across all your notes by name.
- Status bar counter — See how many tasks are pending at a glance, right in the VS Code status bar.
- Daily note templates — New daily notes are created from a configurable template.
- Real-time sync — All views update automatically when files change on disk.
- Remote workspace support — Works over SSH, WSL, and GitHub Codespaces.
🚀 Getting Started
- Open VS Code with a folder or workspace.
- Click the NotesVS icon in the Activity Bar (left side).
- Hit the
+ button in the Notes Explorer to create your first note.
🎮 Usage
Notes Explorer
| Action |
How |
| Create note |
Click $(new-file) in the view header, or Cmd/Ctrl+Alt+N |
| Create folder |
Click $(new-folder) in the view header |
| Rename |
Right-click → Rename |
| Delete |
Right-click → Delete (moves to system trash) |
| Move |
Drag & drop into a folder |
| Search |
Click $(search) in the view header, or Cmd/Ctrl+Alt+F |
Wiki-links
In any markdown note, type [[Note Name]] to create a link to another note:
See also [[Meeting Notes]] and [[Project Plan]].
Clicking the link opens the target file. If the note doesn't exist yet, clicking creates it.
Pending Tasks
All - [ ] checkboxes found in your notes appear in the Pending Tasks view, grouped by file. Click the checkbox to mark a task done — the change is written back to the file. Use the $(check-all) button in the view header to toggle display of completed tasks.
Calendar & Daily Notes
Click any day in the Calendar view to open (or create) that day's note. Days with existing notes show a blue dot. Daily notes are stored under calendar daily notes/YYYY-MM/ inside your notes root.
Status Bar
The $(checklist) N pending item in the status bar shows your pending task count. Click it to jump directly to the Tasks view.
⚙️ Settings
| Setting |
Default |
Description |
notesvs.locale |
en-US |
Locale for date formatting (e.g. es, fr, pt-BR). Reload required after change. |
notesvs.notesRoot |
.vscode/NotesVS |
Notes folder path, relative to the workspace root. Reload required after change. |
notesvs.showCompletedTasks |
false |
Show completed tasks in the Tasks view by default. |
notesvs.dailyNoteTemplate |
# {date}\n\n## Notes\n\n## Tasks\n\n |
Template for new daily notes. Use {date} as a placeholder. |
Important: Changing notesvs.locale after daily notes have been created will cause the calendar not to find existing notes, since filenames are locale-formatted.
⌨️ Keyboard Shortcuts
| Shortcut |
Action |
Cmd/Ctrl+Alt+N |
Create new note |
Cmd/Ctrl+Alt+F |
Search notes |
👨💻 Author
mariorodrigueeez
NotesVS — Your productivity, simplified.
