✨ Become an AI-era PM — words → product → doAIPM.com
SoloMD
PROMOTER PROGRAM Tell people about SoloMD — your name goes in it. How it works
v5.2.3 · just shipped · MIT · 5 platforms · ⭐ 1.7k · 111.7k downloads

All the calm of Typora.
Plus 5-platform sync & local AI. Free.

Pure WYSIWYG & live preview, built-in 9-format export (no Pandoc setup needed), vault-scoped encrypted sync across macOS, Windows, Linux, iOS & Android, and zero-config local AI + 16-tool MCP server. MIT-licensed, ~14–30 MB — no account, no subscription, no plugin tax.

Open source · MIT·Signed & notarized·No account·No ads·Free forever

SoloMD v5.2 — Pure WYSIWYG editor, 5-platform vault sync, unified 9-format export, and local AI
⚡ Or one-line install
curl -fsSL https://solomd.app/install.sh | bash
irm https://solomd.app/install.ps1 | iex
See all platforms ↓
✍️ Pure WYSIWYG📤 9-format export☁️ Free 5-platform sync🔗 Wiki links & RAG🤖 Local + 20 BYOK AI🔌 16-tool MCP

SoloMD 5.2

Writing first. Tools out of the way.

5.0 redesigns every surface: a quieter window, a centered reading column, formatting right where you select — and the same feel on all five platforms.

A quieter window

The toolbar folds into a single header row, the status bar becomes a small word-count pill, and your text sits in a centered column. Fold arrows show up only when you reach for them.

SoloMD 5.0 with the sidebar hidden: a single header row and a centered column of text

Format what you select

Select a phrase and bold, link, heading and quote float right beside it — no shortcut to remember, no menu to dig through.

A selection toolbar floating above selected text in SoloMD 5.0

Source and preview, side by side

Split puts your Markdown next to the rendered page, scrolling together. Live, Source, Split and Preview are one click apart.

SoloMD 5.0 split view: Markdown source on the left, the rendered page on the right

Five platforms. One calm.

macOS, Windows, Linux, iPhone and iPad, Android — the same window, the same shortcuts, the same Markdown files.

SoloMD 5.0 on Windows
Windows
SoloMD 5.0 on iPad
iPad
SoloMD 5.0 on iPhone
iPhone

TL;DR — what SoloMD is, in 60 seconds

SoloMD is a free, open-source Markdown editor and local vault for macOS, Windows, Linux, Android, and iOS. ~14–30 MB installer (~14 MB Windows, ~16 MB Linux, ~30 MB dual-arch macOS Universal DMG — 3–7× smaller than Typora and Obsidian). MIT licensed. Pure WYSIWYG & Live Preview, built-in 9-format export (no Pandoc install needed), free vault-scoped encrypted sync, Wiki links, local RAG semantic search, 20+ BYOK + local AI providers, AutoGit, and a 16-tool MCP server — all built in.

Latest version
5.2.3 · released 2026-11-18
Price
$0 forever · no paid tier · no subscription
License
MIT · source on GitHub
Platforms
macOS · Windows · Linux (x64 + ARM64) · Android (API 24+) · iOS (15+)
Installer size
~14 MB Win · ~16 MB Linux · ~30 MB Mac Universal (vs Typora ~70 MB · Obsidian ~110 MB)
Memory at idle
~80–150 MB
UI languages
15 (en, zh, ja, ko, de, fr, es, pt, it, pl, nl, tr, sv, uk, ru)
AI providers
20+ BYOK + OPR local auto-discovery (Ollama, LM Studio, vLLM, llama.cpp, Jan, OpenAI, Claude, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, OpenRouter…)
Data collection
Anonymous usage counts only, off with one switch · no accounts · notes never leave your device
Tech stack
Tauri 2 + Rust + Vue 3 + CodeMirror 6

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 too — the replies you get are written by an AI, not typed by a person.

We say so because you should know what you are trusting with your notes, and because a reply can be confidently wrong. When one is, say so in the thread — that correction is the mechanism.

The same 1-architect + Claude Code pipeline also shipped Unterm — a custom Rust + wgpu terminal kernel exposing 152 MCP methods with an Action Gateway.

Built around the way you actually work

Three short stories. Pick the one that sounds like you.

For writers & creators

Pure WYSIWYG prose & 1-click 9-format publishing

Open a folder, switch to Pure WYSIWYG or Focus mode, and write in a quiet centered column. When the draft is done, the Unified Export Center turns it into a styled PDF, Word (.docx), EPUB, HTML, or LaTeX document out of the box — no external Pandoc install required.

  • 3 editing modes: Pure WYSIWYG, Live Preview, and Split/Source
  • Built-in 9-format export center with live preview & zero Pandoc setup
  • Focus + typewriter + fullscreen slideshow (`⌘⌥P`) modes
  • First-class CJK character count, encoding detection & OpenCC conversion
For researchers & knowledge workers

A local vault that syncs across 5 platforms for $0

Connect notes with [[wikilinks]], backlinks, and YAML properties. Semantic RAG search ranks paragraphs by meaning across your vault, while vault-scoped encrypted sync keeps your work and personal folders separate across Mac, Windows, Linux, iPhone, and Android.

  • 100% offline semantic RAG search — no model download, no cloud call
  • Vault-scoped sync via iCloud, OneDrive, WebDAV, S3, or GitHub/GitLab
  • Every `⌘S` snapshots into a local AutoGit history you can diff & restore
  • Zero-config local AI (Ollama / LM Studio) + 20+ BYOK providers
For developers & AI power users

Your vault is already a 16-tool MCP endpoint & CLI

A bundled `solomd-mcp` sidecar exposes 16 tools (with multi-vault federation) to Claude Desktop, Cursor, Windsurf, or Claude Code. Extend your workflow with lightweight declarative JSON plugins and the `solomd` CLI v2.

  • 16-tool MCP server bundled — stdio or loopback HTTP, `--allow-write` gated
  • Multi-vault federation (`--workspace path1 --workspace path2`)
  • Declarative JSON extensions (`.solomd/plugins/*.json`) for slash commands & webhooks
  • `solomd open / new / list / search / export / daily` CLI v2

Built different — on purpose

Five principles that decide what we ship and what we say no to.

🏠

Local-first by default

Files on disk. AI keys in the OS keychain. The semantic-search embedder runs in our Rust process — no model download, no relay.

📜

MIT licensed, fully auditable

Every claim on this site is checkable in the source. Read the security writeup or grep the repo yourself.

Read /security →
🚫

No account, no cloud, your notes stay yours

Your notes never leave your device. SoloMD sends anonymous usage counts (features used, version, OS) — never your files, IP or anything personal — and one switch in Settings turns that off. There is no SoloMD account.

How we count things →
📄

Plain .md files forever

Uninstall SoloMD and your notes are still there — UTF-8 text, in folders you picked, openable in any editor.

💬

Friendly community on GitHub Discussions

Ideas, polls, show-and-tell, Q&A. One developer, one room, no Discord.

See the community →

Calm like Typora. Connected like a vault.
Built-in sync, export & AI — zero plugin tax.

Stop choosing between a single-file editor that can’t sync to your phone and a 110 MB Electron app that charges $96/yr for sync and breaks whenever a community plugin updates. SoloMD ships all three layers in one lightweight native app (~14 MB on Windows, ~30 MB dual-arch macOS Universal).

✍️ v5.2

Three seamless writing modes

Switch effortlessly between Pure WYSIWYG (syntax markers stay hidden even on the active line), Live Preview (markers reveal only on the caret line), and synced Split / Source view.

📤 v5.2

Unified 9-format export center

Export PDF (with KaTeX & Mermaid), Word (.docx), HTML, EPUB, LaTeX, ODT, RTF, Plain Text, and Markdown out of the box with live preview — zero external Pandoc install needed. Drag in .docx / .pdf / .xlsx / .pptx to convert to Markdown on the spot.

☁️ v5.2

Vault-scoped cloud & Git sync

Bind each workspace independently to iCloud Drive, OneDrive, Nutstore, Baidu/Aliyun Drive, Syncthing, WebDAV, S3/R2, or GitHub/GitLab/Gitea — with optional AES-256-GCM / XChaCha20 end-to-end encryption and conflict copy protection.

📱 v5

Native across all 5 platforms

One quiet window on macOS, Windows (x64 + ARM64), Linux (x64 + ARM64), iPhone & iPad, and Android — with cross-device session restore so your open tabs follow you everywhere.

🦙 v5.2

Zero-config local AI + 20+ BYOK

One-click OPR auto-discovery detects local Ollama, LM Studio, Jan, vLLM, and llama.cpp servers on localhost. Or plug in your own key for 20+ cloud providers (OpenAI, Claude, Gemini, DeepSeek, Qwen, GLM, Kimi, Groq, OpenRouter, etc.) stored in your OS keychain.

🔌 v5.2

16-tool MCP server & CLI v2

Bundled solomd-mcp sidecar exposes your vault (or multiple federated vaults) to Claude Desktop, Cursor, Windsurf, and Claude Code. Plus solomd CLI v2 for terminal search, headless export, and daily notes.

🧩 v5.2

Lightweight JSON extensions

Customize workflows without Electron bloat: drop declarative JSON files into .solomd/plugins/ for custom / slash templates, regex/template Command Palette transforms, and one-click Webhook publishers.

🔗

Wiki links, backlinks & properties

Connect thoughts with [[wikilinks]], inspect incoming backlinks, and edit YAML frontmatter properties — structured knowledge management without a fragile plugin maze.

🔍

On-device semantic RAG search

⌘⇧F ranks paragraphs across your entire vault by meaning, not just exact keywords. Runs 100% locally in Rust — no model file download, no network call, ever.

📜

AutoGit snapshot on every save

Every ⌘S writes an automatic commit to a local .git inside your workspace (libgit2 built in, no system git needed). Browse visual diffs in the sidebar and roll back in one click.

🌏

First-class CJK & encoding support

Auto encoding detection (UTF-8 / GBK / GB18030 / Big5 / Shift_JIS) via chardetng, accurate CJK word/character count, Simplified ↔ Traditional conversion, and pinyin export.

🦀

Lightweight native Rust + Tauri 2

~14 MB on Windows, ~16 MB on Linux, ~30 MB for dual-arch macOS Universal DMG — 3–7× smaller than Typora (~70 MB) and Obsidian (~110 MB). Instant cold start, ~80 MB idle RAM, 8 themes + custom CSS, MIT open source.

Quality-of-life touches

🎤

Slideshow mode

⌘⌥P renders the active doc as fullscreen slides, split on `---`. Vim-style nav, code highlighting, KaTeX, Mermaid all work in slides.

💻

CLI v2 tool

`solomd open / new / list / search / export / daily` — drive and automate your vault from the terminal. One-line installer.

🪄

Format Markdown

⌘⌥L runs Prettier — normalizes lists, tables, spacing. Front matter preserved.

👋

Welcome tour

First launch opens 4 in-memory tutorial tabs in your language (en / 中文). Reopen anytime via the command palette.

⌨️

Vim mode

Full Vim emulation: hjkl, modes, visual, :w :q, macros. Toggle in Settings.

🤖

Clean AI artifacts

One click removes LLM junk: [cite_start], 【†source】, smart quotes, zero-width chars.

🎯

Focus & typewriter modes

Dim non-active paragraphs. Keep cursor centered. Long-form writing without distraction.

⌨️

Command palette

⌘⇧K to access every command. Native menu bar on macOS / Windows / Linux.

Where SoloMD stands out

Typora’s calm writing feel + Obsidian’s local vault + built-in 5-platform sync, 9-format export & local AI. Everything below ships in core — zero plugin tax.

📤

Built-in 9-format export

Export PDF, Word (.docx), EPUB, HTML & LaTeX out of the box with live preview — unlike Typora or Obsidian, zero external Pandoc install needed.

☁️

Free 5-platform vault sync

Sync across macOS, Windows, Linux, iOS & Android via iCloud, OneDrive, WebDAV, S3, or Git with E2EE — no $96/yr Obsidian Sync subscription.

🦙

Zero-config local AI & 16-tool MCP

OPR auto-detects local Ollama / LM Studio, plus 20+ BYOK providers, local semantic RAG search, and a bundled 16-tool MCP server.

SoloMD Typora MarkText Obsidian
Pure WYSIWYG + Live Preview + Split modes ✅ v5.2 ✅ ✅ 🟡 (Live Preview only)
Built-in 9-format export (no Pandoc install needed) ✅ v5.2 🟡 (requires Pandoc) ❌ 🟡 (PDF only / plugins)
Native iOS & Android apps ✅ v5 ❌ ❌ ✅
Free vault-scoped cloud & Git sync (you own the data) ✅ v5.2 ❌ ❌ ❌ (Obsidian Sync is $96/yr)
End-to-end encrypted vault sync ✅ ❌ ❌ ✅ ($96/yr paid sync)
Zero-config local AI (OPR auto-detect Ollama / LM Studio) ✅ v5.2 ❌ ❌ 🟡 (community plugins)
20+ BYOK AI providers (keys in OS keychain) ✅ v5.2 ❌ ❌ 🟡 (1–2 per plugin)
Bundled 16-tool MCP server + multi-vault federation ✅ v5.2 ❌ ❌ ❌
Lightweight declarative JSON extensions ✅ v5.2 ❌ ❌ ✅ (heavy JS plugins)
Local semantic RAG search (100% offline) ✅ ❌ ❌ 🟡 (community plugins)
AutoGit version history on every save ✅ ❌ ❌ 🟡 (manual git plugin)
Open source · MIT ✅ ❌ ✅ (dormant) ❌
Installer size ~14 MB (Win) / ~30 MB (Mac Universal) ~70 MB ~80 MB ~110 MB
Price Free $14.99 Free Free + $96/yr sync
Linux ARM64 + Windows ARM64 native builds ✅ ❌ ❌ 🟡
CJK encoding (GBK/Big5) + word count + OpenCC ✅ ❌ ❌ ❌
File import (DOCX/PDF/XLSX/PPTX → Markdown) ✅ ❌ ❌ 🟡 (plugin)
Slideshow / presentation mode ✅ ❌ ❌ 🟡 (plugin)

Download SoloMD v5.2.3

Free and open source. MIT license. No account needed.

macOS: Drag SoloMD.app to /Applications. Notarized — no Gatekeeper warning.
Windows: First launch may show "Windows protected your PC" → click More info → Run anyway (one-time, until reputation builds).
Linux: chmod +x SoloMD-*.AppImage && ./SoloMD-*.AppImage for the AppImage. Needs Ubuntu 22.04 / Debian 12 or newer — will yours work? →
Chrome: Chrome Enhanced Protection scans each new release and reports "No viruses detected" — that is a pass, not a warning. Every release ships a SHA256SUMS.txt if you want to verify the file yourself. SHA256SUMS.txt →

Package managers

Homebrew macOS
brew install --cask zhitongblog/solomd/solomd
AUR Arch Linux
yay -S solomd-bin

Updates arrive with your normal package upgrades.

Looking for older versions? All releases →
Faster from mainland China: AtomGit mirror (G-Star) → · Faster from mainland China: Gitee mirror →

Frequently asked questions

Is SoloMD really free?

Yes. SoloMD is MIT-licensed open-source software at https://github.com/zhitongblog/solomd. There is no paid tier, no subscription, no feature paywalls, and no ads. Compare: Typora costs $14.99, iA Writer costs $29.99, Obsidian Sync is $96/year. Every SoloMD feature is $0 forever — optional one-time in-app tips on macOS, iOS, and Android exist purely to support independent development and unlock the "✨ Supporter" badge.

Is there a free alternative to Typora?

Yes — SoloMD gives you all the calm of Typora (Pure WYSIWYG, Live Preview, tabs, themes, PDF / Word export) plus capabilities Typora lacks: built-in 9-format export with zero external Pandoc setup, native iOS & Android apps, free vault-scoped encrypted sync, local RAG semantic search, and 20+ BYOK / local AI providers. Typora costs $14.99; SoloMD is $0 forever under the MIT license.

What is the best free Markdown editor in 2026?

SoloMD is the most complete free Markdown editor in 2026: native across 5 platforms (macOS, Windows, Linux, Android, iOS), ~14–30 MB installer, MIT-licensed, with Pure WYSIWYG + Live Preview, Wiki links, built-in 9-format export, local RAG, 20+ BYOK AI providers + OPR local model discovery, AutoGit, 16-tool MCP server, and 8 themes — all in core. MarkText has been dormant since 2023, and Obsidian is a ~110 MB closed-source Electron app that charges $96/yr for official sync.

How does SoloMD compare to Typora?

SoloMD is free ($0, MIT open source); Typora is $14.99 and closed-source. SoloMD is ~3–5× smaller (~14 MB on Windows / ~30 MB macOS Universal vs ~70 MB). SoloMD runs natively on iOS and Android in addition to macOS, Windows, and Linux; Typora is desktop-only. And unlike Typora, SoloMD exports Word/EPUB/LaTeX out of the box without requiring you to install Pandoc manually, plus adds folder-level Wiki links, free multi-cloud/Git sync, AutoGit version history, local RAG search, and AI/MCP integration.

How does SoloMD compare to Obsidian?

SoloMD is ~4–7× lighter (~14–30 MB Tauri/Rust vs ~110 MB Electron) and 100% MIT open source. SoloMD ships Pure WYSIWYG writing, free vault-scoped encrypted sync (iCloud, OneDrive, WebDAV, S3, GitHub), 9-format export, AutoGit snapshots, local semantic search, 20+ BYOK AI providers, and a 16-tool MCP server right in core — zero plugin tax and zero $96/yr sync subscription.

Does SoloMD work on Android and iOS?

Yes. SoloMD v5.2 ships native Android (API 24+, ARM64 + ARMv7 + x86_64) and iOS/iPadOS (15+) apps. Android is available on Google Play and as direct .apk downloads on GitHub Releases; iOS and iPadOS are on the App Store (apps.apple.com/app/id6762498874). Both mobile apps share the same calm v5 interface, Wiki links, AI rewrite, and folder/cloud sync.

Does SoloMD work offline?

Yes, 100%. The editor makes zero mandatory network requests. Local RAG semantic search runs on an on-device Rust embedder with no model download and no cloud call. AutoGit commits to a local .git repository inside the workspace and never auto-pushes. AI calls only happen when you trigger them and connect directly to your chosen local or BYOK provider.

How big is the installer?

~14 MB on Windows (.msi / portable), ~16 MB on Linux (.deb / .rpm), ~21 MB on Android (arm64 .apk), and ~30 MB for the dual-architecture macOS Universal .dmg (bundling both Apple Silicon and Intel binaries). That is 3–7× smaller than Typora (~70 MB) and Obsidian (~110 MB) because SoloMD uses Tauri 2 (system webview + Rust) instead of bundling Chromium. Idle memory is ~80–150 MB.

Does SoloMD need an AI subscription?

No. SoloMD ships AI rewrite (Cmd+J on a selection) and the Agent Panel with 20+ BYOK — bring your own key — providers (OpenAI, Claude, Gemini, xAI Grok, Mistral, Groq, DeepSeek, Qwen, GLM, Kimi, Doubao, MiniMax, SiliconFlow, OpenRouter, Requesty, Cheaper Inference, Runcrate, OpenCode Go, and Ollama), plus one-click Open Provider Registry (OPR) auto-discovery for local Ollama, LM Studio, vLLM, llama.cpp, and Jan servers. SoloMD itself charges nothing for AI — you pay only your chosen provider per token, or nothing if you run a local model.

Where are my API keys stored?

In your OS keychain — Apple Keychain on macOS, Credential Manager on Windows, libsecret on Linux. Never in localStorage, never in a config file SoloMD writes to disk. AI requests go directly from your machine to the provider you chose; SoloMD does not host models or relay any traffic.

How is SoloMD's semantic search different from grep?

Grep matches characters; semantic search matches meaning. Search 'deployment' and SoloMD's local RAG also surfaces paragraphs about 'rolling out', 'shipping', or 'release'. The embedder runs entirely in our Rust process — no model file download, no network call, no cloud. Off by default; flip the switch in Settings to opt in. Index lives in <workspace>/.solomd/embeddings.sqlite (auto-gitignored).

How does the MCP server work?

SoloMD bundles solomd-mcp, a lightweight sidecar binary that speaks the Model Context Protocol over stdio or loopback HTTP. Point Claude Desktop, Cursor, Windsurf, Claude Code, or Codex CLI at one or multiple federated workspaces to use 16 built-in tools (list_notes, read_note, search, semantic_search, get_backlinks, list_tags, get_outline, export_note, autogit_log, autogit_diff, autogit_rollback, etc.), with write tools safely gated behind --allow-write.

Can I sync my notes to other devices?

Yes. SoloMD includes built-in Vault-Scoped Cloud Drive Sync (Settings → Sync → Cloud Drive) for iCloud Drive, OneDrive, Baidu Netdisk, Aliyun Drive, Nutstore, and Syncthing with optional AES-256-GCM end-to-end encryption (.solomd-enc) and conflict protection, as well as GitHub / GitLab / Gitea / WebDAV / S3 sync.

Does SoloMD support plugins or extensions?

SoloMD ships every heavy feature in core (Pure WYSIWYG, Wiki links, semantic RAG search, AutoGit, 20+ BYOK AI providers, unified 9-format export, MCP server, Pomodoro, Vim mode) so you never pay an Electron plugin tax. For custom workflows, v5.2+ includes lightweight declarative JSON User Extensions (Settings → Extensions or <workspace>/.solomd/plugins/*.json) for custom / slash templates, regex/template Command Palette transforms, and one-click Webhook publishers.

What languages does SoloMD support?

The UI ships in 14 languages: English, Simplified Chinese (zh-CN), Japanese, Korean, German, French, Spanish, Portuguese, Italian, Polish, Dutch, Turkish, Swedish, and Ukrainian. Auto-detected from your OS locale on first launch, switchable in Settings. The document content itself is encoding-agnostic — SoloMD auto-detects UTF-8 / UTF-16 / GBK / GB18030 / Big5 / Shift_JIS files.

How does SoloMD handle CJK / Chinese files?

SoloMD is Chinese-first: chardetng-based auto encoding detection (UTF-8 / GBK / GB18030 / Big5 / Shift_JIS), CJK word count in the status bar (counts characters, not space-separated tokens), Simplified ↔ Traditional Chinese conversion via OpenCC, pinyin export, and bundled Noto Sans CJK / WenQuanYi font fallback on Linux. Typora and Obsidian do none of these natively.

How do I install SoloMD?

One line. macOS / Linux: run 'curl -fsSL https://solomd.app/install.sh | bash' in a terminal — the script auto-detects your OS and CPU architecture and installs the latest release. Windows: open PowerShell and run 'irm https://solomd.app/install.ps1 | iex'. Or download platform-specific installers (.dmg / .msi / .AppImage / .deb / .rpm / .apk) from https://github.com/zhitongblog/solomd/releases/latest. Average install time: under 2 minutes on a normal connection.

What are the system requirements? Does SoloMD run on Windows 7?

SoloMD requires Windows 10 or later, macOS 10.15+, a current mainstream Linux distribution, iOS 15+, or Android 7+. Windows 7/8/8.1 cannot be supported and no legacy build exists: the Rust toolchain that compiles SoloMD requires Windows 10 (since Rust 1.78), and Microsoft froze WebView2 — the engine SoloMD renders in — at version 109 on Windows 7 with no further security updates. On an older PC, a practical alternative is the Android app on a phone or tablet pointed at the same notes folder.

Contact / Join the room

One maintainer, two front doors. WeChat for the Chinese community, Telegram channel for everyone else. GitHub Discussions works too — link below.

WeChat (personal)

WeChat (personal)

Scan to add me on WeChat. Mention "SoloMD" so I know it's you.

Telegram channel @SOLOMDAPP

@SOLOMDAPP

Click or scan to join. Release announcements + chat live here.

💼 Need an Agent-Native Desktop App or Custom MCP Runtime? The architect behind SoloMD (1,500+ ⭐, 16 MCP tools) and Unterm (custom Rust/wgpu terminal kernel, 152 MCP tools) is available for 100% async remote contracts — written specs, Loom demos & production PRs, zero meetings. Hire the architect → 🚀 SoloMD was built by one person — with AI. Want to ship a real product solo with Claude Code? I wrote down the exact pipeline — idea → spec → build → QA → ship. Learn the playbook →