Skip to content

Repository files navigation

WitNote

WitNote

Smart Core, Simple Form
A clean, lightweight, and local-first Markdown companion.

English | 简体中文 | 🌐 Official Website

License Version Platform Architecture

Download on the Mac App Store


🍃 Returning to Simplicity: Our Philosophy

In an era where writing software and AI tools are becoming increasingly complex, heavy, and bloated with endless configurations, WitNote stays true to its original purpose:

Fast, distraction-free, and elegant Markdown dual-pane editing.

We focus on doing the core essentials to perfection:

  • Instant Open: Open any local .md / .txt file or vault instantly without waiting.
  • 🌓 Pure Dual-Pane: Write on the left, live-render on the right (with full GFM & LaTeX math support).
  • 📴 Offline First: All files remain 100% on your local disk.
  • 🤖 Lightweight AI Companion: AI is not a complicated, intrusive agent here—it functions simply as an offline encyclopedia, translator, and writing assistant.

🍎 Apple Ecosystem (Native Swift Architecture)

For macOS, iOS, and iPadOS, WitNote has transitioned to a 100% pure native architecture written in Swift & SwiftUI.

  • Why Native? Native Apple architecture deeply integrates with Apple Silicon hardware and macOS system energy-efficiency frameworks, offering instantaneous startup, buttery-smooth scrolling, and zero runtime container overhead.
  • Mac App Store: Directly search "WitNote" on the App Store or Click Here to Download to enjoy official sandbox protection and silent updates.
  • iOS & iPadOS: Native mobile versions are currently under active development.
  • (Note: Mac users who prefer the open-source Electron build can still compile and run it from source code.)

📦 Open Source Releases (Windows & Linux)

The open-source edition will continue active, long-term development, dedicated to providing the cleanest cross-platform Markdown workspace for Windows and Linux users.

From v2.0.1 onward, official binary packages natively support both x86_64 and ARM64 architectures:

Platform Architecture Package Format Download
🪟 Windows x86_64 (Intel/AMD) Setup Installer (.exe) Releases
🪟 Windows ARM64 (Snapdragon/Surface) Setup Installer (.exe) Releases
🐧 Linux x86_64 / ARM64 Universal AppImage (.AppImage) Releases
📦 Linux (Debian/Ubuntu) x86_64 / ARM64 Debian Package (.deb) Releases

✨ Key Features (v2.0.1)

  • 📝 Pure Markdown & File Vault — Open any folder directly as a workspace. No databases, no proprietary lock-in. Everything is a file.
  • 🧮 Flawless LaTeX & Code Blocks — Robust math rendering for multi-line formulas, alignments, matrices, and code highlighting.
  • 🛡️ Hardened Security — Built-in DOMPurify sanitization; links open safely in your default browser.
  • 🤖 Clean AI Integration — Connect effortlessly with Ollama (local powerful models) or Cloud API (DeepSeek, OpenAI, etc.) with quick one-click context clearing.
  • 🎨 Minimalist Card UI — Clean frosted glass aesthetic, custom themes (Light / Dark / Tea), and focus mode.

🛠️ Build from Source

# Clone repository
git clone https://github.com/hooosberg/WitNote.git
cd WitNote

# Install dependencies
npm install

# Start development mode
npm run dev

# Package for Windows
npm run build:win

# Package for Linux
npm run build:linux

📄 License & Privacy

  • License: MIT License. Open source and free.
  • Privacy: 100% local storage. We never collect or upload your notes or private keys.

About

WitNote is a local-first AI writing companion for macOS and Windows.

Topics

Resources

Stars

565 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages