What's new in 3.1.0 — Constellation
- Board task toggling — click checkbox to mark done, card moves lanes, Markdown file is rewritten, history snapshot taken first.
- Task-toggle server hang fixed — handler no longer blocks on duplicate body read.
- Front-matter integrity — favorite/pinned no longer flip to true on any rewrite; updated bumps correctly.
- No save-on-open churn — opening/switching notes no longer rewrites unchanged notes.
- Debounced network lookups — backlinks/related refresh 250 ms after you stop typing.
- 69/69 E2E checks pass.
Multi-view Workspace
- Notes — the core Markdown editor with slash commands and templates
- Board — every checkbox task grouped by project and lane (Overdue / Today / Next 7 days / No date / Done)
- Graph — deterministic force-directed canvas of wiki links with drag, zoom and folder-colored nodes
- Tags — a tag cloud with usage counts; select a tag to list notes
- Trash — browse, restore and permanently empty deleted notes
Quick capture from the sidebar with Ctrl+Shift+N creates a timestamped Inbox note. Slash block commands (type /) support headings, lists, quotes, code fence, tables and date inserts.
Run
git clone https://github.com/PeaBox-Lab/Portable-Notes.git
cd Portable-Notes
python app.py
Open http://127.0.0.1:8765 or double-click start.bat on Windows.
Custom vault
python app.py --vault "D:\Notes\My Vault"
Your notes are ordinary .md files under vault/ by default. Portable Notes binds to 127.0.0.1, includes no telemetry and requires no account. Open the same notes with Obsidian, Notepad++, VS Code or any Markdown editor.
Keyboard Shortcuts
| Shortcut | Action |
|---|
Ctrl+N | New note |
Ctrl+S | Save |
Ctrl+K | Search |
Ctrl+Shift+P | Command palette |
Ctrl+Shift+1—“5 | Switch views (Notes †’ Board †’ Graph †’ Tags †’ Trash) |
Ctrl+\ | Focus mode — hides all panels |
Ctrl+B / Ctrl+I | Bold / Italic |
Ctrl+F | Find and replace |
Knowledge Features
The interactive knowledge graph renders [[wiki links]] as a force-directed canvas. Click a node to open a note, hover for details. The related-notes panel uses Evernote-style tag similarity to suggest matching notes.
Full-text search is backed by SQLite FTS5 with ranked results and saved searches. Unlinked mentions detect when a term also appears as a note title or alias. Duplicate detection surfaces notes with matching titles.
Task Intelligence
Markdown checkboxes are aggregated across the vault. Add due: YYYY-MM-DD or 📅 YYYY-MM-DD to a task to expose its due date. Enhance tasks with priority: high, !high, project: Alpha or #project/Alpha.
Portable Notes marks incomplete past-due tasks as overdue and exposes commands in the palette for Dashboard, Calendar, Board, 7-day focus, Weekly review, Productivity stats, Project health, Project workspace, Project timeline, Milestones, Milestone board, Task dependencies, Critical path, Risk radar, Workload, Capacity, Burndown, Delivery forecast, Schedule plan, Schedule slippage, Baseline health, Metadata quality and Execution readiness.
Documentation