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
area
details
writing
live preview, shiki highlighting, mermaid diagrams, media previews, task lists, mark/strike syntax, reading mode, editor-only mode, opt-in vim
ai context
stage sidebar files, see file/token counts, copy one AI-ready bundle with relative paths
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.
terminal command (macOS)
Use marka open notes.md or marka open --wait notes.md.
In the app, use Help or the command palette’s install marka command
action. It installs a launcher at ~/.local/bin/marka without changing shell settings.
If needed, add export PATH="$HOME/.local/bin:$PATH" to your shell profile.
--wait finishes when the tab closes or the app quits, not when the file is saved.
Closing a tab is not an approval signal for an agent. Use marka --help for usage.
The command accepts one existing .md, .markdown, or .mdx file, including
quoted paths with spaces. Exit codes: 0 success, 1 launch/open failure,
2 invalid input, 130 cancelled with Ctrl-C.
On macOS the new bundle is named marka.app; the product is still marka.md.
An in-app update preserves the old folder name. To remove .app from the Finder
label on an older installation, quit normally, rename marka.md.app to
marka.app in Applications, then reopen it and reinstall the terminal command.
Do not replace an existing destination or edit the signed bundle’s contents.
Windows (10+, x64)
grab marka.md_*-setup.exe → run. Windows SmartScreen may ask for confirmation because the Windows build is unsigned.
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.
key
does
⌘K
command palette
⌘O
open a .md file
⌘⇧O
open a folder of notes
⌘N
new untitled buffer
⌘T
new untitled tab
⌘S
save
⌘⇧S
save as (also handles untitled buffers)
⌘B
toggle sidebar
⌘1…9
switch to tab 1 through 9
⌘.
toggle reading mode (preview only)
⌘⇧.
toggle editor-only mode (preview hidden)
⌘= / ⌘+ / ⌘-
zoom the whole app in / out (50%–300%, persisted)
⌘0
reset zoom
⌘F
find / replace in editor · or find in reading mode
⌘G
find next match
⌘⌥Z
undo last sidebar file op (move / rename / new / delete)
⌘⇧C
copy markdown to clipboard
command palette → copy context bundle
copy the staged context bundle
⌘P
export to pdf (also visible in the top file-action row)
⌃⌘F
toggle fullscreen (macOS) · F11 on Windows/Linux
⌘/
help overlay
⌘,
settings
esc
close any popup
stack
layer
choice
shell
tauri 2.12 (rust + webview), macOS universal (arm64 + x86_64) · Windows · Linux
frontend
react 19 · vite 7 · typescript 7 · bun
editor
codemirror 6 + @codemirror/lang-markdown + @codemirror/search · opt-in vim via @replit/codemirror-vim
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)
评论