macOS · free · open source

mdmini

A minimalist live-preview markdown editor for macOS. Lightweight, fast, and distraction-free.

$ install brew tap malinborn/mdmini && brew install --cask mdmini
Download GitHub
mdmini screenshot — live-preview markdown editor
What it does
Everything you need,
nothing you don't
✦
Live Preview
Markdown renders inline as you type. No split pane, no preview toggle.
▤
GFM Tables
Create, edit, reorder, and delete table rows and columns. Drag to reorder.
◧
Collapsible Headings
Click any heading to fold the section below it. Keeps long docs navigable.
◈
Syntax-Highlighted Code
Fenced code blocks render with language-aware syntax highlighting.
◇
Mermaid Diagrams
Flowcharts, sequence, class, Gantt, ER, pie, mindmap — all render inline as SVG.
◉
Secret Masking
Values in .env files are blurred by default. Click to reveal.
⟳
File Watching
External changes to open files are detected and reloaded automatically.
⌘
CLI Launcher
Open files instantly from the terminal with mdmini file.md.
↓
Dock Drop
Drag any file onto the Dock icon to open it. Works with multiple files at once.
◑
Dark & Light Themes
Rosé Pine dark and Rosé Pine Dawn. Switch with a single keypress.
⏺
Auto-Save & Recovery
Changes are saved continuously. Crash recovery restores your last session.
Quick start
Zero config, instant open
zsh
~ $ brew tap malinborn/mdmini && brew install --cask mdmini
==> Downloading mdmini...
==> Installing mdmini
✓ mdmini installed

~ $ mdmini README.md
# Opens in a native macOS window

~ $ mdmini *.md notes/*.md
# Each file gets its own window

~ $ brew update && brew upgrade --cask mdmini
# Update to latest version

~ $
Releases
Changelog
v0.2.2
2026-04-05
feature

Line Glow & heading fold redesign

  • Line Glow — subtle gradient glow on active line, toggle via View menu
  • Fold toggle — ▾/▸ inline after headings with glow when folded
v0.2.1
2026-04-05
feature

Heading fold toggle redesign

  • Inline fold toggle — ▾/▸ appears right after heading text, no layout shift
  • Glow indicator — folded sections show ▸ with subtle glow
v0.2.0
2026-04-05
feature

Mermaid Diagrams

  • Live diagram preview — ```mermaid blocks render as inline SVG diagrams
  • All diagram types — flowcharts, sequence, class, state, ER, Gantt, pie, gitgraph, mindmap
  • Lazy-loaded — zero overhead for documents without diagrams
  • Hybrid errors — shows last valid diagram + error overlay while editing
  • Theme-aware — diagrams adapt to light/dark theme
v0.1.6
2026-04-03
fix

Foreground windows

  • Windows open in foreground — new windows from CLI now appear on top via NSApp activate
v0.1.5
2026-04-02
feature

File associations & smart windows

  • Dock file drop — drag files onto the Dock icon to open
  • File associations — macOS registers mdmini for .md, .txt, .json, .py, .rs, .yml, .toml, .sh
  • Smart window reuse — drag-drop and Dock drop open in empty windows
  • No white flash — dark background set before CSS loads
  • Cmd+Z safety — undo no longer clears content after file open
v0.1.4
2026-04-02
fix

Text wrapping & table alignment

  • Text wrapping — long text wraps correctly even with wide tables
  • Gutter cleanup — removed gray bar, auto-hides on horizontal scroll
  • Table alignment — consistent column alignment across all rows
v0.1.3
2026-03-30
fix

Update checks & theme fixes

  • Update banner — correct brew command with brew update prefix
  • Theme menu — single checkmark radio behavior
  • Hourly update checks while app is open
v0.1.0
2026-03-30
initial

Initial release

  • Live preview — inline markdown rendering via CodeMirror 6 decorations
  • GFM tables — create, edit, reorder rows/columns, drag-drop
  • Collapsible headings — click to fold sections
  • Syntax highlighting — fenced code blocks with language detection
  • Secret masking — .env values blurred by default
  • File watching — external edits reload automatically
  • CLI launcher — mdmini file.md via Homebrew tap
  • Themes — Rosé Pine dark & dawn
  • Auto-save & crash recovery