MacDown is an open source Markdown editor for OS X, released under the MIT License. The author stole the idea from Chen Luo’s Mou so that people can make crappy clones.

Visit the project site for more information, or download MacDown.app.zip directly from the latest releases page.

Download, unzip, and drag the app to Applications folder. MacDown is also available through Homebrew Cask:

brew install --cask macdown

MacDown is released under the terms of MIT License. You may find the content of the license here, or inside the LICENSE directory.

You may find full text of licenses about third-party components in the LICENSE directory, or the About MacDown panel in the application.

The following editor themes and CSS files are extracted from Mou, courtesy of Chen Luo:

• Mou Fresh Air
• Mou Fresh Air+
• Mou Night
• Mou Night+
• Mou Paper
• Mou Paper+
• Tomorrow
• Tomorrow Blue
• Tomorrow+
• Writer
• Writer+
• Clearness
• Clearness Dark
• GitHub
• GitHub2

If you wish to build MacDown yourself, you will need the following components/tools:

• OS X SDK (10.14 or later)
• Git
• Bundler

Note: Old versions of CocoaPods are not supported. Please use Bundler to execute CocoaPods, or make sure your CocoaPods is later than shown in Gemfile.lock.

Note: The Command Line Tools (CLT) should be unnecessary. If you failed to compile without it, please install CLT with

xcode-select --install

and report back.

An appropriate SDK should be bundled with Xcode 5 or later versions.

After cloning the repository, run the following commands inside the repository root (directory containing this README.md file):

git submodule update --init
bundle install
bundle exec pod install
make -C Dependency/peg-markdown-highlight

and open MacDown.xcworkspace in Xcode. The first command initialises the dependency submodule(s) used in MacDown; the second one installs dependencies managed by CocoaPods.

Refer to the official guides of Git and CocoaPods if you need more instructions. If you run into build issues later on, try running the following commands to update dependencies: