发现一个丝滑的 Markdown 编辑器，专为 AI 聊天上下文管理场景设计。

基于 Tauri + React + TypeScript 构建，跨平台支持 macOS / Windows / Linux。

左侧 CodeMirror 6 编辑器，右侧 markdown-it + Shiki + Mermaid 实时预览，支持 8 套主题、Vim 模式、命令面板、文件侧边栏、阅读模式、PDF 导出。

https://github.com/mattenarle10/markamd…

mattenarle10/markamd

Source: https://github.com/mattenarle10/markamd

marka.md

a local markdown editor for the notes you share with ai.

a cross-platform (macOS · Windows · Linux) markdown editor specialized for ai context management. live editor on the left (codemirror 6), rendered preview on the right (markdown-it + shiki + mermaid), and a context tray for staging multiple notes into one AI-ready bundle. minimal chrome, grouped themes (neutral + catppuccin + ai-inspired + crafted), orange octopus mascot. ~10 mb bundle, ~240 mb resident — lean for a tauri app.

built around one loop: collect notes → write → share with ai. nothing leaves your machine until you copy.

works with claude, chatgpt, gemini, your local agent — anywhere that reads plain markdown.

features

• live preview — ~50 ms render, shiki code highlighting (36 langs, lazy-loaded), mermaid diagrams
• grouped themes — mono, mono dark, catppuccin family, crafted palettes, plus AI-inspired Claude / Codex / Gemini / Cursor themes · animated sections + hover-to-preview
• reading mode — ⌘. distraction-free preview with iA-style typography
• editor-only mode — ⌘⇧. hide the preview when you want to focus on writing
• vim mode — opt-in via theme menu · NORMAL/INSERT/VISUAL/REPLACE pill in the status bar
• find — ⌘f works in BOTH editor (codemirror) and reading mode (text-node walker w/ live highlights)
• command palette — ⌘k, fuzzy + grouped
• ide-style sidebar — drag-to-move, right-click rename / new / delete, ⌘⌥Z undo
• session restore — last open file + folder come back on launch
• save as — ⌘⇧s opens save-as dialog (also auto-fallback for untitled buffers)
• markdown extras — ==highlight== (mark), ~~strike~~, [ ] / [x] task lists with theme-aware checkboxes
• share to ai — ⌘⇧c copies clean markdown to clipboard
• context tray — stage multiple sidebar files, see file/token counts, copy them as one prompt bundle
• export to pdf — visible file-action button + ⌘p
• external file watch — auto-reloads when the file changes outside the app · conflict toast on dirty buffer
• cross-platform auto-update — minisign-signed releases on macOS / Windows / Linux
• window transparency slider — continuous opacity, macOS vibrancy
• platform-aware shortcuts — ⌘ on mac, Ctrl on Windows/Linux, surfaced correctly everywhere
• no autosave — ⌘s commits. trust your fingers, not background daemons.

install

download the latest release →

macOS (notarized + auto-updating, universal arch coverage)

• apple silicon (M1/M2/M3/M4): grab marka.md.dmg → drag marka.md.app into /Applications → open.
• intel mac: grab marka.md_intel.dmg → same install steps.

Windows (10+, x64)

grab marka.md_*-setup.exe → run.

Windows SmartScreen may show “Windows protected your PC”. Click More info → Run anyway. marka.md is free + MIT — we don’t sign Windows builds (paid certs aren’t worth it for a free OSS project). Full source is right here if you’d rather build it yourself.

Linux (x86_64)

three flavors, pick what fits your distro:

• AppImage (works anywhere): chmod +x marka.md_*.AppImage → run. self-contained, no install step needed.
• .deb (Debian / Ubuntu / Mint / Pop!_OS): sudo dpkg -i marka.md_*_amd64.deb
• .rpm (Fedora / RHEL / Rocky / openSUSE): sudo dnf install marka.md-*.x86_64.rpm

no signing required on Linux — it’s the freedom platform 🐧

from source

requires bun (or npm), rust toolchain. on macOS: xcode command line tools. on Windows: MSVC build tools (Visual Studio installer → “Desktop development with C++”). on Linux: libwebkit2gtk-4.1-dev libsoup-3.0-dev + friends.

bun install
bun run tauri dev      # native window with hmr
bun run tauri build    # produces .dmg / .exe / .AppImage / .deb / .rpm under src-tauri/target/release/bundle/

keyboard

shortcuts shown with macOS modifiers below. on Windows / Linux, substitute ⌘ → Ctrl, ⌥ → Alt, ⇧ → Shift.

stack

project structure

src/
├── app.tsx              # shell — composes hooks + renders layout
├── components/
│   ├── primitives/      # button, icon, popover, kbd, shortcut, tooltip
│   ├── chrome/          # title-bar, breadcrumb, status-bar, logo
│   ├── editor/          # editor, preview, splitter, reading-find
│   ├── files/           # sidebar, file-tree, folder-node, editable-row, sidebar-search, context-menu
│   └── overlays/        # palette, help, about, welcome, drop, toast
├── hooks/                # use-file-session, use-file-ops, use-update-flow, use-context-menu,
│                        # use-overlays, use-notifications, use-shortcuts, use-file-watcher,
│                        # use-sync-scroll, use-debounced, use-persisted-state
├── lib/                  # markdown, theme, platform, files, commands, pdf-export, updater,
│                        # window-drag, storage, bundle, demo
├── styles/               # tokens, globals, per-domain css (chrome/, editor/, files/, overlays/, shared/)
└── assets/mascot/        # in-app sprites
src-tauri/                # rust shell, tauri config, capabilities
.github/workflows/        # release.yml (matrix build) + ci.yml + dependabot

every folder exports its public api via index.ts. path alias @/* resolves to src/*. state lives in cohesive custom hooks under src/hooks/; app.tsx is mostly composition + jsx.

roadmap

per-release detail lives on the changelog (auto-fresh from GitHub releases). high-level:

v1.5:

• context tray — multi-file bundling, ⌘-click to stage, token estimates, copy as one prompt blob
• what’s new toast — first launch after update now points users straight to the changelog
• pdf export polish — cleaner document margins, no browser-added date/time/path headers, and rendered mermaid diagrams
• theme polish — mono / mono dark, animated grouped theme menu, and AI-inspired Claude / Codex / Gemini / Cursor palettes
• code block wrapping — long rendered code lines wrap in preview and PDF export
• macOS file handling — default-handler launches open the selected markdown file reliably

next:

• native/silent PDF generation, so export does not depend on the browser print dialog
• optional richer context bundle presets for agents with stricter prompt formats

contributions welcome — see feedback below to suggest priorities.

privacy

local-first. nothing ever leaves your machine. no telemetry, no analytics, no accounts, no cloud sync. your .md files stay on disk. clipboard transfers happen only when you press ⌘⇧C — and then they’re yours, going wherever you paste them.

see the full privacy notice for the website analytics caveat (vercel speed insights, cookieless).

feedback

ideas, bugs, or just want to say hi?

• structured form (GitHub) — feedback · bug report
• prefer email? → [email protected]
• landing page hub → markamd.vercel.app/feedback
• security issues → SECURITY.md

i read everything. PRs welcome.

support

marka.md is free + MIT, and intends to stay that way. if it saves you time wrangling AI context:

• ⭐ star the repo — biggest single signal
• 🗣️ tell another dev / share it

both appreciated, neither required. 🐙

license

mit · matt enarle (@mattenarle10)