vmark

vmark

An AI friendly markdown editor.

Stars: 77

Visit
 screenshot

VMark is a modern, local-first Markdown editor designed for the AI era. It combines the simplicity of rich text editing with the power of source mode. Built to work seamlessly with AI assistants, it understands Chinese, Japanese, and Korean text. Users can switch between rich text and source mode effortlessly, with beautifully designed themes and offline functionality. The tool offers advanced features like AI integration, CJK text handling, customization options, and various export formats.

README:

VMark

The Markdown Editor That Gets It Right

Free. Smart. Beautiful. Yours.

VMark AI Integration - Claude Code, Claude Desktop, and VMark

VMark is a modern, local-first Markdown editor designed for the AI era. It combines the simplicity of rich text editing with the power of source mode — clean when you need focus, powerful when you need control.

Download · Documentation · Features

Contribution Rules (Early Read)

Before opening issues or pull requests, read:

VMark is a vibe-coded codebase. We enforce three rules to keep quality stable:

  1. Detailed bug descriptions before direct code improvement.
  2. 100% test coverage for changed behavior and changed code paths in every PR.
  3. Single-focus PRs only.

Why VMark?

AI-Native

Built to work seamlessly with AI assistants. Claude, Codex, and Gemini can read your documents, suggest edits, and write content directly — no plugins required.

  • One-click setup for Claude Desktop, Claude Code, Codex CLI, Gemini CLI
  • AI suggestions appear inline for your review
  • Accept or reject changes with a keystroke

CJK Done Right

Finally, a Markdown editor that understands Chinese, Japanese, and Korean text. Smart spacing between CJK and Latin characters, proper punctuation handling, and 19+ formatting rules — all built in.

  • Automatic CJK-Latin spacing
  • Fullwidth punctuation conversion
  • Corner bracket quotes for CJK
  • One shortcut to fix everything: Alt + Cmd + Shift + F

Two Modes, Zero Friction

Switch instantly between rich text (WYSIWYG) and source mode. See your formatting rendered beautifully, or dive into the Markdown source when you need precision.

  • Rich text mode powered by Tiptap/ProseMirror
  • Source mode powered by CodeMirror 6
  • Toggle with Cmd + /

Beautifully Designed

Five hand-crafted themes designed for extended writing sessions. Typography that respects your fonts. An interface that stays out of your way.

  • White — Clean and minimal
  • Paper — Warm and gentle
  • Mint — Fresh and focused
  • Sepia — Classic reading feel
  • Night — Easy on the eyes

Local-First, Always

Your documents stay on your machine. No cloud services, no accounts, no tracking. VMark works entirely offline.


Features

Category What You Get
Editing Rich text, source mode, focus mode, typewriter mode
Formatting Headings, lists, tables, code blocks, blockquotes
Advanced Math equations (LaTeX), Mermaid diagrams, wiki links
AI Integration MCP support for Claude, Codex, Gemini
CJK 19+ formatting rules for Chinese, Japanese, Korean
Customization 165 keyboard shortcuts, 5 themes, font controls
Export HTML, PDF, copy as HTML

Installation

macOS (Recommended)

Homebrew:

brew install xiaolai/tap/vmark

Manual Download:

Download the .dmg from the Releases page.

  • Apple Silicon (M1/M2/M3): VMark_x.x.x_aarch64.dmg
  • Intel: VMark_x.x.x_x64.dmg

Windows & Linux

Pre-built binaries are available on the Releases page. Active development is focused on macOS; Windows and Linux builds are provided as-is.


AI Integration

VMark speaks MCP (Model Context Protocol) natively. Connect your favorite AI assistant in one click:

  1. Open Settings → Integrations
  2. Enable MCP Server
  3. Click Install for your AI assistant
  4. Restart the AI assistant

That's it. Your AI can now read, edit, and write to your VMark documents.

Supported assistants:

  • Claude Desktop
  • Claude Code
  • Codex CLI
  • Gemini CLI

Keyboard Shortcuts

VMark has 165 customizable shortcuts. Here are the essentials:

Shortcut Action
Cmd + / Toggle Rich Text / Source Mode
F8 Toggle Focus Mode
F9 Toggle Typewriter Mode
Cmd + S Save
Cmd + Shift + V Paste as Plain Text
Alt + Cmd + Shift + F Format CJK Text

See the full list in Settings → Keyboard Shortcuts or the documentation.


Documentation


Building from Source

For developers who want to contribute or build VMark locally.

Prerequisites

Quick Start

# Clone
git clone https://github.com/xiaolai/vmark.git
cd vmark

# Install dependencies
pnpm install

# Run in development mode
pnpm tauri dev

# Build for production
pnpm tauri build

Development Commands

Command Description
pnpm tauri dev Start development mode
pnpm test Run tests
pnpm lint Run linter
pnpm check:all Lint + test + build

Project Structure

vmark/
├── src/                    # React frontend
├── src-tauri/              # Rust backend (Tauri)
├── vmark-mcp-server/       # MCP server
├── website/                # Documentation (VitePress)
└── plugins/                # Claude Code skills

Tech Stack

  • Framework: Tauri v2 (Rust backend)
  • Frontend: React 19, TypeScript, Zustand
  • Rich Editor: Tiptap (ProseMirror)
  • Source Editor: CodeMirror 6
  • Styling: Tailwind CSS v4

AI-Assisted Development

The repo ships with full configuration for AI coding tools (Claude Code, Codex CLI, Gemini CLI). Project rules, conventions, and architecture docs are pre-loaded — the AI already knows how VMark works.

  • AGENTS.md — Single source of truth for all AI tool instructions
  • .claude/ — Rules, slash commands, skills, and subagent definitions (developer guide)
  • .mcp.json — MCP server config (Codex for cross-model auditing, Tauri for E2E testing)

See the Users as Developers guide for details.


License

Private - All rights reserved.


Questions? Open an issue · Updates? Watch this repo

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for vmark

Similar Open Source Tools

For similar tasks

For similar jobs