https://github.com/scabir/notebranch
An open source desktop Markdown workspace with Git, AWS S3, and local first for notes; built with Electron, React, and TypeScript.
https://github.com/scabir/notebranch
aws-s3 cross-platform desktop-app electron git knowledge-base knowledge-management linux-desktop mac-desktop markdown markdown-editor mermaid note-taking notes-app productivity react typescript vite wiki windows-desktop
Last synced: 3 months ago
JSON representation
An open source desktop Markdown workspace with Git, AWS S3, and local first for notes; built with Electron, React, and TypeScript.
- Host: GitHub
- URL: https://github.com/scabir/notebranch
- Owner: scabir
- License: mit
- Created: 2025-11-16T10:12:41.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-03-29T00:34:00.000Z (3 months ago)
- Last Synced: 2026-03-29T01:52:51.548Z (3 months ago)
- Topics: aws-s3, cross-platform, desktop-app, electron, git, knowledge-base, knowledge-management, linux-desktop, mac-desktop, markdown, markdown-editor, mermaid, note-taking, notes-app, productivity, react, typescript, vite, wiki, windows-desktop
- Language: TypeScript
- Homepage: https://notebranch.app
- Size: 84.5 MB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# NoteBranch
Your Markdown workspace for real projects, docs, and personal knowledge bases, backed by Git, AWS S3, or Local storage.
[](https://github.com/scabir/notebranch/actions/workflows/coverage.yml)
[](https://github.com/scabir/notebranch/actions/workflows/integration.yml)
[](https://github.com/scabir/notebranch/actions/workflows/macos-dmg.yml)
[](https://github.com/scabir/notebranch/actions/workflows/windows-installer.yml)
[](https://github.com/scabir/notebranch/actions/workflows/linux-packages.yml)
Official website: [notebranch.app](https://notebranch.app)
**Version**: 2.9.1
**License**: MIT
## Built for daily note workflows
NoteBranch keeps your notes where your work already lives. Write in Markdown, connect to your repository type of choice, and keep everything organized and versioned in one desktop app.
## See it in action
### Write and preview side by side
### Organize notes quickly
### Work in your language
Supported languages:
- English
- Chinese (中文)
- Hindi (हिन्दी)
- Spanish (Español)
- German (Deutsch)
- Arabic (العربية)
- French (Français)
- Russian (Русский)
- Portuguese (Português)
- Japanese (日本語)
- Turkish (Türkçe)
- Italian (Italiano)
- Polish (Polski)
- Ukrainian (Українська)
- Kurdish (Kurdî)
- Swedish (Svenska)
- Greek (Ελληνικά)
### Use NoteBranch in dark mode
## What you can do
- Connect Git, AWS S3, or Local repositories
- Create Markdown notes with editor, preview, and split view
- Organize files and folders with rename, move, duplicate, and favorites
- Search and replace in current file and across the repository
- Review file history and versions
- Export the current note or the full repository as ZIP
## Installation
All releases: [github.com/scabir/notebranch/releases](https://github.com/scabir/notebranch/releases)
## Website
Live website: [notebranch.app](https://notebranch.app)
Static product website source:
[app/website/README.md](app/website/README.md)
## User Guide
New to NoteBranch? Start here with a complete walkthrough:
[Read the User Guide with setup steps, daily workflows, and troubleshooting](docs/USER_GUIDE.md)
## Tutorials
- [Connect Git Repository](tutorials/scenarios/connect-git-repository/README.md)
- [Create and Edit Markdown (Preview + Split)](tutorials/scenarios/create-and-edit-markdown-preview-split/README.md)
- [Organize Files: Rename, Move, Duplicate, Favorite](tutorials/scenarios/organize-files-rename-move-duplicate-favorite/README.md)
- [Search and Replace (File + Repository)](tutorials/scenarios/search-and-replace-file-and-repo/README.md)
- [Commit, Pull, Push from Status Bar](tutorials/scenarios/commit-pull-push-from-status-bar/README.md)
- [View History and Restore Reference](tutorials/scenarios/view-history-and-restore-reference/README.md)
- [Export Note and Repository ZIP](tutorials/scenarios/export-note-and-export-repository-zip/README.md)
- [Connect AWS S3 Bucket with Prefix](tutorials/scenarios/connect-s3-bucket-with-prefix/README.md)
- [Edit and Auto-Sync Pending Changes](tutorials/scenarios/edit-and-auto-sync-pending-to-synced/README.md)
- [AWS S3 History with Versioned Objects](tutorials/scenarios/s3-history-with-versioned-objects/README.md)
- [Create Local Repository and Work Offline](tutorials/scenarios/create-local-repository-and-work-offline/README.md)
- [Local Save and Reopen Persistence Check](tutorials/scenarios/local-save-and-reopen-persistence-check/README.md)
- [Switch Language and Verify Persistence](tutorials/scenarios/switch-language-and-verify-persistence/README.md)
Tutorial hub: [tutorials/README.md](tutorials/README.md)
## Technical Documentation
- [Technical Documentation](docs/tech/README.md)
## Support
Open an issue: https://github.com/scabir/notebranch/issues
## Outro
Thanks for using NoteBranch.
Built and maintained by **Suleyman Cabir Ataman**.