The markdown viewer Linux never had.
A real standalone app — not a browser tab, not an IDE panel — that opens in a
blink, gets out of your way, and looks good doing it.
A 1.8 MB native markdown viewer + editor for Linux. markm file.md opens it
instantly and gives your shell prompt straight back; Esc closes it. Sixteen
themes restyle everything — chrome, page, code, editor. It also edits
(CodeMirror 6), reloads live when the file changes on disk and highlights what
changed, and shows a git word-diff against HEAD. No Electron, no browser tab,
no IDE.
git clone https://github.com/galvani/markm && cd markm
pnpm install && pnpm build
pnpm exec neu build --release
scripts/install.sh # ~/.local + MIME + .desktop
xdg-open README.md # markm is now your markdown handlerJump to: Why · Features · Shortcuts · Install · Develop
Every other option was ugly, slow, stuck on one theme, or trapped inside VS Code. markm gets four things right:
⚡ Throwaway by design — one command to open,
Escto close, prompt never blocked.🎨 Sixteen themes, applied everywhere — chrome, page, code and editor, together.
✍️ An editor and a git diff too — live reload highlights what changed; Changes word-diffs against HEAD.
🪶 1.8 MB, native, instant — system WebKitGTK. No Chromium, no Electron.
| Dark | Light |
|---|---|
| Dark · Dracula · Nord · Tokyo Night · One Dark · Monokai · Catppuccin Mocha · Everforest · Gruvbox Dark · Solarized Dark · Rosé Pine | Light · Catppuccin Latte · Gruvbox Light · Solarized Light · Rosé Pine Dawn |
- Browse — opens the current file's folder, that file preselected. Type to filter.
- Code blocks — highlighted in 15 languages, themed, with a Copy button.
- Images — local ones render inline.
- Links — external open in your browser, local
.mdopen here,#anchorsscroll. - Reading font — System / Sans / Serif / Mono, auto-scaling with window width.
- Zoom —
Ctrl+/-/0, orCtrl+ wheel. The toolbar stays put. - Remembers — theme, font, zoom, mode, folder, scroll and window size, per file.
- Native —
xdg-open/ "Open With" via a.desktopentry + MIME association.
| Shortcut | Action |
|---|---|
Ctrl E |
Toggle edit/view |
Ctrl S |
Save |
Ctrl O |
Open |
Ctrl + / - |
Zoom in / out |
Ctrl 0 |
Reset zoom |
Esc |
Close (in View mode / picker) |
- Neutralino.js — native shell that uses the OS WebKitGTK (no bundled runtime). See SPEC.md for why this over Tauri/Electron.
- Svelte 5 + Vite — frontend.
- CodeMirror 6 — source editor.
- markdown-it — renderer.
- diff — word-level diff for the Changes view.
Requires Node (via nvm) and pnpm.
pnpm install
pnpm build # compile the Svelte frontend into dist/
pnpm app # launch the native window (neu run)
# or in one step:
pnpm startpnpm dev runs vite build --watch for an iterative loop (rebuilds dist/ on
change; relaunch pnpm app to pick changes up).
pnpm build
pnpm exec neu build --release # -> dist/markm/markm-linux_x64 + resources.neu
scripts/install.sh # installs under ~/.local, registers MIME + .desktopThen xdg-open any.md (or a file manager, or "Open With") launches markm.
Remove with scripts/uninstall.sh.
Build a macOS .app
Run this on macOS:
pnpm install
scripts/package-macos-app.sh # universal app: dist/macos/markm.app
# or: pnpm run package:macos-app
# or: scripts/package-macos-app.sh arm64
# or: scripts/package-macos-app.sh x64
open dist/macos/markm.appThe script builds the Svelte bundle, runs neu build --release, creates
appIcon.icns from public/icons/appIcon.png with macOS sips/iconutil, and
wraps the Neutralino binary in a normal markm.app/Contents/... bundle. It is
not signed or notarized.
Redistribution
neu build produces the portable binary + resources.neu bundle — the basis
for an AppImage / .deb / tarball. scripts/package-macos-app.sh produces a
macOS .app bundle. Node is only a build-time tool; it is never shipped. See
SPEC.md.
- BUILD.md — Linux install and macOS
.appbuild steps. - SPEC.md — what markm is, the architecture, and why these choices.
- JOURNAL.md — decisions and gotchas, newest first.