MdMan

A lightweight Markdown viewer and editor for macOS.

Features

• Welcome screen: Opens without forcing a file dialog - get started with a clean slate
• Drag & drop: Drop a .md file or paste a file path directly into the window
• Command line support: Open files from Terminal with MdMan /path/to/file.md
• Three view modes: Edit, Split (side-by-side), and Preview
• Rich Markdown rendering: Headers, bold, italic, strikethrough, code blocks, links, lists, blockquotes, horizontal rules
• Open / Save / Save As: Native macOS file dialogs (Cmd+O, Cmd+S, Cmd+Shift+S)
• Adjustable font size: Increase/decrease editor and preview font size
• Live word count: Lines, words, and characters displayed in the toolbar
• Dark mode support: Fully compatible with macOS light and dark themes
• Signed and notarized: Ready to distribute

Installation

Download

Download the latest MdMan.dmg from the Releases page, open it, and drag MdMan to Applications.

Build from source

git clone https://github.com/Prodevking1/MdMan.git
cd MdMan
swift build -c release

The binary will be at .build/release/MdMan.

Usage

GUI

• Launch the app - you'll see a welcome screen
• New file: Cmd + N
• Open file: Cmd + O or drag a file onto the window
• Save: Cmd + S
• Save As: Cmd + Shift + S
• Switch view mode: Use the segmented control in the toolbar
• Adjust font size: Use the + / - buttons in the toolbar

Command line

# Open a file directly
/Applications/MdMan.app/Contents/MacOS/MdMan ~/Documents/notes.md

# Or create an alias
alias mdman='/Applications/MdMan.app/Contents/MacOS/MdMan'
mdman README.md

Drag & drop

• Drop any .md, .markdown, or .txt file onto the window
• Drop or paste a file path (e.g. from Terminal) to open it

Requirements

• macOS 14.0 (Sonoma) or later
• Swift 5.9+

License

MIT License. See LICENSE for details.

Credits

Made by Abdoul