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, rendered preview, file tabs, csv preview, grouped themes, smarter command palette, and a context tray for staging multiple notes into one AI-ready bundle.

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

works with claude, chatgpt, gemini, local agents, and anything that reads plain markdown.

what you get

install

download the latest release →

macOS

• homebrew: brew install --cask mattenarle10/tap/marka-md
• 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.

Homebrew users can update with brew update && brew upgrade --cask marka-md. The in-app signed updater still works too.

Windows (10+, x64)

grab marka.md_*-setup.exe → run. Windows SmartScreen may ask for confirmation because the Windows build is unsigned.

Linux (x86_64)

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
• AUR (Arch and derivatives): yay -S markamd-appimage or paru -S markamd-appimage

from source

requires bun, rust, and platform build tools. on Linux, install libwebkit2gtk-4.1-dev libsoup-3.0-dev and related Tauri deps.

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

roadmap

Per-release detail lives on the changelog.

• v1.5 core loop: context tray, file tabs, CSV preview, grouped themes, interface languages, PDF/export polish, file workflow improvements, preview link handling, and scroll memory
• v1.5.12 polish: smoother preview scrolling, cleaner sidebar, refreshed demo doc, quickstart tutorial updates, and smarter command palette search
• v1.5.18 polish: playable media previews and faster tab shortcuts
• v1.6.0 workflow: separate preview windows, command-palette markdown insertions, and Traditional Chinese localization
• v1.6.1 workflow: automatic folder monitoring, native file watching, and lazy markdown highlighting
• v1.7.1 workflow: quick file previews, app-wide zoom, and faster folder watching
• v1.7.2 patch: public updater downloads, active-file reload reliability, and Linux Wayland AppImage startup
• v1.7.6 patch: manual explorer refresh and Tauri 2.12
• v1.7.7 patch: TLS security update for the updater and public updater download links
• next: native/silent PDF generation
• next: context handoff presets for bring-your-own-ai workflows, starting with markdown and XML-tag bundle formats

Release work follows the release checklist, including the post-release site refresh check.

contributors

Thanks to everyone helping shape marka.md through PRs, issues, testing, and feedback.

Small, focused PRs are easiest to review and ship. Good places to help:

• bug fixes from the issue tracker
• platform polish for Windows, Linux, and Intel macOS
• markdown, mermaid, PDF, and translation edge cases
• small UX improvements with screenshots or short screen recordings

Before opening a PR:

• keep one behavior change per PR when possible
• include screenshots for UI changes
• update help/about/readme copy when the user-facing surface changes
• run bun test, bun run build, and cargo check --release from src-tauri

privacy

local-first. no telemetry, no accounts, no cloud sync. your .md files stay on disk, and clipboard transfers happen only when you copy.

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

support

marka.md is free + MIT. if it saves you time, star the repo, share it with another dev, or support ongoing development through Open Collective.

license

mit · matt enarle (@mattenarle10)