Skip to main content
Glama

SoloMD

All the calm of Typora. Plus 5-platform vault sync, 9-format export & local AI — free.

Latest release License: MIT Downloads GitHub stars AtomGit Website

🌐 中文 · 日本語 · 한국어 · Deutsch · Français · Español · Português · Italiano · Polski · Nederlands · Türkçe · Svenska · Українська · 🪞 AtomGit mirror → · Gitee mirror → (faster downloads from China)

Download v5.2.0 · AtomGit Releases · What's new in v5.2 · Compare vs Obsidian & Typora · Website · Security

⭐ If SoloMD earns a place on your machine, star it on GitHub — it's free, made by one developer, and stars are how other people find it.

SoloMD editor

🤖 Built and maintained by Claude

SoloMD is written, tested and released almost entirely by Claude Code, Anthropic's coding agent, working under a human maintainer who sets the direction and decides what ships. Issues and pull requests are triaged and answered by Claude as well — the replies you get here are written by an AI, not typed by a person.

We are telling you this for two reasons. You should know what you are trusting with your notes: read the code, it is MIT and all of it is public. And when a reply is confidently wrong — it happens — say so in the thread. That correction is the mechanism.

💼 For Teams & Founders (100% Async Contracts): Using this exact human-architect + Claude Code pipeline, the maintainer also built Unterm — a self-developed Rust + wgpu terminal kernel exposing 152 MCP methods with an Action Gateway. Available for 100% asynchronous remote contracts (custom MCP servers, Rust/Tauri agentic desktop apps, and AI workflows — written specs, Loom demos & clean PRs, zero meetings). Work with the architect →

Your notes live in a plain folder. SoloMD gives you Typora’s quiet, centered writing feel, Obsidian’s local-first vault links, free encrypted sync across all 5 platforms, built-in 9-format export, and zero-config local AI + a 16-tool MCP server.

Built on Tauri 2 + Vue 3 + CodeMirror 6 + Rust. ~14 MB on Windows, ~16 MB on Linux (.deb/.rpm), ~21 MB on Android (arm64), and ~30 MB for the dual-arch macOS Universal .dmg. Free, MIT-licensed, no account, no subscription, no plugin tax, no SoloMD-hosted servers. Your notes, AI keys, embeddings index, and git history stay on your device.

What's new in v5.0 – v5.2

  • Three seamless writing modes (v5.2) — Switch anytime between Pure WYSIWYG (Markdown syntax markers stay completely hidden even on the active caret line), Live Preview (markers reveal only on the active line), and synced Split / Source view.

  • Unified 9-Format Export Center (v5.2) — One modal with live preview exports PDF (with KaTeX & Mermaid), Word (.docx), HTML, EPUB, LaTeX, ODT, RTF, Plain Text, and Markdown out of the box — zero external Pandoc installation required.

  • Zero-config local AI (OPR) + 20+ BYOK providers (v5.2) — One-click Open Provider Registry (OPR) auto-discovery detects local Ollama, LM Studio, Jan, vLLM, and llama.cpp servers on localhost. Or plug in your own API key for 20+ cloud providers (OpenAI, Claude, Gemini, DeepSeek, Qwen, GLM, Kimi, Doubao, MiniMax, Groq, Mistral, xAI, SiliconFlow, OpenRouter, etc.) stored in your OS keychain.

  • Vault-scoped encrypted Cloud & Git sync (v5.2) — Bind each workspace independently to iCloud Drive, OneDrive, Nutstore, Baidu/Aliyun Drive, Syncthing, WebDAV, S3 / Cloudflare R2, or GitHub / GitLab / Gitea — with optional AES-256-GCM / XChaCha20-Poly1305 end-to-end encryption and conflict copy protection.

  • Lightweight declarative JSON extensions (v5.2) — Drop simple JSON manifests into <workspace>/.solomd/plugins/*.json (or manage via Settings → Extensions) to add custom / slash templates, regex/template Command Palette transforms, and one-click Webhook publishers — zero Electron plugin bloat.

  • CLI v2 & 16-tool MCP server (v5.2) — solomd open / new / list / search / export / daily / agent / mcp from your terminal, plus solomd-mcp with multi-vault --workspace federation.

Related MCP server: mcp-markdown-vault

Three pillars in one lightweight native app

  1. Calm writing & publishing. Pure WYSIWYG + Live Preview + Split view, floating selection formatting bar, Focus & Typewriter modes, fullscreen Slideshow (⌘⌥P), Vim mode, KaTeX math + Mermaid diagrams, image paste to _assets/, built-in 9-format export, and .docx / .pdf / .xlsx / .pptx drag-and-drop import to Markdown. First-class CJK encoding detection (UTF-8 / GBK / Big5 / Shift-JIS), character counts, and Simplified ↔ Traditional conversion.

  2. Connected local vault across 5 platforms. Native apps for macOS, Windows (x64 + ARM64), Linux (x64 + ARM64), iOS/iPadOS, and Android with cross-device session restore. [[Wikilinks]], backlinks, YAML frontmatter properties, 100% offline semantic RAG search (⌘⇧F), AutoGit snapshot on every ⌘S (libgit2 built in), and free vault-scoped encrypted sync.

  3. Local AI & MCP endpoint. Inline AI rewrite (⌘J), right-side Agent Panel (streamed chat-with-vault, [[wikilink]] citations, inline tool cards), OPR local model auto-discovery + 20+ BYOK providers, and the bundled solomd-mcp binary exposing 16 tools to Claude Desktop, Cursor, Windsurf, and Claude Code.

Feature

What it does

3 Editing Modes (v5.2)

Pure WYSIWYG (no syntax shift on active line), Live Preview, and synced Split / Source view.

Unified 9-Format Export (v5.2)

Built-in live-preview export to PDF, DOCX, HTML, EPUB, LaTeX, ODT, RTF, TXT, and MD — no external Pandoc setup needed.

Vault-Scoped Cloud & Git Sync (v5.2)

Per-workspace sync via iCloud, OneDrive, Nutstore, Baidu/Aliyun Drive, Syncthing, WebDAV, S3/R2, or GitHub/GitLab/Gitea with optional E2EE.

OPR Local AI + 20+ BYOK (v5.2)

Auto-discover local Ollama / LM Studio / Jan / vLLM / llama.cpp, or use 20+ BYOK cloud providers. Keys live in your OS keychain.

Declarative JSON Extensions (v5.2)

.solomd/plugins/*.json adds custom /slash templates, regex/template text transforms, and one-click Webhook publishing.

Agent Panel & AI Rewrite

Streamed chat-with-vault ([[wikilink]] citations, Insert/Copy to note) and ⌘J inline selection rewrite/translate.

Bundled 16-Tool MCP Server

solomd-mcp ships in the app. Supports --workspace path1 --workspace path2 multi-vault federation, stdio (default) and loopback Streamable HTTP.

AutoGit per note

Every ⌘S commits a snapshot to a local .git inside your workspace. libgit2 vendored, no system git required. Visual diff & 1-click rollback.

Offline Semantic Search (RAG)

⌘⇧F ranks paragraphs by meaning across your vault using an on-device Rust embedder — zero model downloads, zero network calls.

Use it

1. Write, link, and export. Open any folder of .md files. Switch between Pure WYSIWYG, Live Preview, and Split view in the top header; press ⌘⇧E (or File → Export) to open the Unified 9-Format Export Center.

2. Chat with your vault or rewrite inline. Select text and press ⌘J for inline AI rewrite/translation, or open the right-side Agent Panel (⌘⇧P → View: Toggle Agent Panel) for multi-turn chat across your notes. Click Auto-detect Local Models in Settings → AI to connect local Ollama / LM Studio in one click.

3. Drive your vault from Claude Desktop, Cursor, or Claude Code:

# Print the MCP config snippet for your AI client…
solomd mcp-config
# …or register it automatically across AI clients on your machine:
solomd mcp install
{
  "mcpServers": {
    "solomd": {
      "command": "/Applications/SoloMD.app/Contents/MacOS/solomd-mcp",
      "args": ["--workspace", "/Users/me/Documents/SoloMD"]
    }
  }
}

For multi-vault federation, repeat --workspace:

"args": [
  "--workspace", "/Users/me/Documents/SoloMD",
  "--workspace", "/Users/me/Documents/work-notes"
]

4. Or hand a prompt to claude / codex CLI directly:

solomd agent "summarize this week's daily notes into a weekly review and commit it"

MCP tools (16 built in)

Kind

Tools

Read (always on)

list_notes, read_note, search, get_backlinks, get_outline, list_tags, list_tasks, autogit_log, autogit_diff, sync_status, share_url, read_agent_trace

Write (--allow-write)

write_note, append_to_note, autogit_rollback, export_note

Transports: stdio (default, what Claude Desktop / Cursor / Cline / Codex use), or Streamable HTTP for local/hosted clients:

solomd-mcp --workspace ~/Documents/SoloMD --transport http --bind 127.0.0.1:8765 --auth-token "$TOKEN"

Command line (CLI v2)

curl -fsSL https://raw.githubusercontent.com/zhitongblog/solomd/main/scripts/install-cli.sh | bash
solomd help

Commands: open, new, daily, list, search, cat, export, agent, mcp list|install|uninstall|config, mcp-config, --version.

Install

Latest release (v5.2.0) and every download: GitHub Releases · AtomGit Mirror · Gitee Mirror.

System requirements: Windows 10+, macOS 10.15+, current mainstream Linux, iOS 15+, Android 7+ (API 24).

macOS — universal dmg (Apple Silicon + Intel, signed + notarized)

brew install --cask zhitongblog/solomd/solomd

Or one-line shell install:

curl -fsSL https://solomd.app/install.sh | bash

Or direct download: SoloMD_5.2.0_universal.dmg · Mac App Store

Windows — x64 & ARM64

irm https://solomd.app/install.ps1 | iex
winget install solomd

Linux — x86_64 + aarch64

  • .AppImage (universal), .deb (Debian/Ubuntu), .rpm (Fedora/RHEL) — both architectures on the releases page.

  • Arch Linux: solomd-bin on AUR.

iOS / iPadOS & Android

Compared

SoloMD v5.2

Obsidian

Typora

MarkText

License

MIT (Open Source)

Proprietary (free)

Paid ($14.99)

MIT (dormant since 2023)

Stack

Tauri 2 (Rust + native WebView)

Electron

Electron

Electron

Platforms

macOS · Win · Linux · iOS · Android

macOS · Win · Linux · iOS · Android

macOS · Win · Linux

macOS · Win · Linux

Installer

~14 MB (Win) / ~16 MB (Linux) / ~30 MB (Mac Universal)

~110 MB

~70 MB

~80 MB

Pure WYSIWYG + Live Preview + Split

✅ All 3 modes

🟡 Live Preview only

✅

✅

Built-in 9-format export (no Pandoc install)

✅ v5.2

🟡 PDF only (plugins for others)

🟡 Requires external Pandoc

❌

Free vault-scoped cloud & Git sync

✅ iCloud / OneDrive / WebDAV / S3 / Git

❌ ($96/yr Obsidian Sync)

❌

❌

End-to-end encryption

✅ On your own storage

✅ Paid Obsidian Sync only

❌

❌

Zero-config local AI (OPR auto-detect)

✅ Ollama / LM Studio / Jan / vLLM

🟡 Community plugins

❌

❌

BYOK AI providers built in

✅ 20+ providers (OS keychain)

🟡 1–2 per community plugin

❌

❌

MCP server bundled

✅ 16 tools + multi-vault federation

❌ (community plugins)

❌

❌

Declarative JSON extensions

✅ .solomd/plugins/*.json

✅ Heavy JS plugins

❌

❌

Local semantic RAG search

✅ 100% offline in Rust

🟡 Community plugins

❌

❌

Version history per note

✅ AutoGit (libgit2 built in)

🟡 Manual git plugin

❌

❌

CJK encodings (GBK / Big5) + OpenCC

✅ Auto-detect

❌

❌

❌

Detailed breakdowns: vs Obsidian · vs Typora · vs Tolaria · vs MarkText.

Privacy & security

Pure client-side. Your .md files stay in the folder you chose. API keys live in the OS keychain (macOS Keychain / Windows Credential Manager / Linux libsecret), never in localStorage or any config file. AI requests go direct from your machine to the provider you picked — no SoloMD relay. RAG embeddings and the AutoGit repo are local-only. The MCP server speaks stdio by default; its optional HTTP transport binds to loopback unless you choose otherwise, and can require a bearer token. The whole codebase is MIT and auditable.

E2EE sync uses AES-256-GCM (.solomd-enc cloud drive sync) and Argon2id → XChaCha20-Poly1305 (Git/remote sync). Plaintext stays on your devices; the remote sees only ciphertext. Path-traversal guards reject .. segments and unauthorized paths across all Tauri and MCP endpoints.

Full writeup: https://solomd.app/security.

Build from source

Prereqs: Rust (stable), Node 18+, pnpm.

git clone https://github.com/zhitongblog/solomd.git
cd solomd/app
pnpm install
pnpm tauri dev      # dev with hot reload
pnpm tauri build    # release artifacts → src-tauri/target/release/bundle/

Linux additionally needs libdbus-1-dev for the keychain backend.

The MCP server is a separate crate at mcp-server/; the dev MCP harness used for end-to-end testing lives at dev-mcp/. End-to-end test entry point: scripts/v4-self-test.sh (run with --with-release --with-ollama --with-ui for full coverage).

Contributing

Issues and PRs welcome — open one. For a sense of direction, see docs/roadmap.md. The v4.0 build log is at solomd.app/blog/v4-0-0-how-we-built-it/ — start there if you want to understand the engineering principles before sending a PR.

Contact / 联系

One maintainer, two front doors. Async on GitHub Discussions. Real-time chat:

  • Telegram (international): @SOLOMDAPP — release announcements + chat

  • WeChat (中文): scan to add me — note "SoloMD" 注明 SoloMD 直接通过

&nbsp;&nbsp;

Sponsors

Thank you to everyone who sponsors SoloMD: tyysoft(太阳雨)

(Note: This is a partial opt-in list — WeChat Pay, Alipay, and App Store / Google Play in-app tips are anonymous by default. If you supported SoloMD and would like your name listed, please open an issue or see solomd.app/thanks.)

✨ 100% Free Forever & Supporter Badge: Every feature in SoloMD is 100% free forever — no paywalls, no subscriptions, no ads. To support independent open-source development, you can sponsor via GitHub Sponsors / PayPal / Alipay / WeChat Pay, or use the 3 optional one-time in-app tip tiers on Mac App Store, iOS App Store, and Google Play (☕ Buy a Coffee $0.99 · 🍜 Buy a Lunch $2.99 · 🚀 Generous Support $9.99) to permanently unlock the exclusive ✨ Supporter badge in Settings and About.

Contributors

Thank you to everyone who helps make SoloMD better — sponsors 💵, testers 🐛🤔, code/theme/packaging contributors 💻🎨📦 and promoters 📣 (All Contributors spec). Full wall of thanks: solomd.app/thanks · Promote SoloMD: solomd.app/promote

License & credits

MIT © 2026 xiangdong li. SoloMD stands on Tauri 2, Vue 3, CodeMirror 6, markdown-it, KaTeX, Mermaid, libgit2, Pandoc, Hunspell, keyring-rs, and rmcp. Sponsor on GitHub Sponsors or via solomd.app/#sponsor.

Open-source hosting & G-Star Program

Special thanks to AtomGit (G-Star Program) for hosting SoloMD's official mirror and release packages in mainland China.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A local-first CLI and MCP server that helps you build and search a personal knowledge vault from Markdown notes, with semantic search and AI-powered features like stale note detection and session memory harvesting. It’s provider-agnostic, requires no GPU in its default mode, and exposes your vault as long-term memory to any MCP-compatible AI tool like Claude Code.
      47
      Apache 2.0
    • A
      license
      B
      quality
      C
      maintenance
      Headless semantic MCP server for Obsidian, Logseq, Dendron, Foam, and any markdown folder. Features built-in hybrid semantic search, surgical AST editing, template scaffolding, zero-config local embeddings, and workflow tracking.
      5
      109 npm
      12
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Local-first markdown vault with a built-in MCP server (streamable HTTP). 16 tools and 2 resources for Claude Code / Desktop / Cursor: read/write/search plus context_for_query, find_orphans, weekly_digest, compare_notes, semantic_outline. Per-folder agent permissions, LanceDB vectors, local Xenova ONNX embedder swappable to Ollama. Single Bun binary. AGPL.
      40
      AGPL 3.0
    • A
      license
      A
      quality
      A
      maintenance
      NoteDiscovery is a self-hosted plain-markdown notes app (MIT, no telemetry) with a built-in stdio MCP server. The server exposes tools so AI clients (Claude Desktop, Cursor, etc.) can search, read, create, edit, tag, and instantiate templates against the same vault the web UI uses.
      22
      2,882
      MIT