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
mdmini screenshot — live-preview markdown editor
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.
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

~ $
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 launchermdmini file.md via Homebrew tap
  • Themes — Rosé Pine dark & dawn
  • Auto-save & crash recovery