How do I install MultiMarkdown?

How do I install MultiMarkdown?

Mac OS X

The easiest way to install MultiMarkdown on the Mac is to use the installer from the downloads page. Simply choose the latest version of the MultiMarkdown-Mac zipfile and download it. Double-click the file to unzip it, and then double click the installer that appears.

If you primarily intend to use MultiMarkdown from within TextMate, or Scrivener, you may wish to also download and install the Support files. This places additional convenience scripts in ~/Library/Application Support/MultiMarkdown which is where Scrivener and TextMate will generally look for it. This installer is also available from the downloads page.

For more advanced users, the installer puts the multimarkdown binary and two convenience scripts, mmd and mmd2tex in the /usr/local/bin directory. As long as /usr/local/bin is included in your PATH environment variable, you can use these binaries from the command line or from other programs.

If you wish to compile MultiMarkdown from source for yourself:

• make sure you have installed the Developer Tools
• you will need several libraries:
  • brew install pkg-config glib gettext
  • OR
  • fink install glib2-shlibs glib2-dev
• git clone git://github.com/fletcher/peg-multimarkdown.git

Then you can compile:

make
make test
make mmdtest
make latextest

Then simply move the binary and convenience scripts to your desired location.

Linux

There is no installer for *nix systems, but you can compile from source fairly easily. For example, on Ubuntu:

sudo apt-get install libglib2.0-dev git
git clone git://github.com/fletcher/peg-multimarkdown.git
make
make test
make mmdtest
make latextest

Other flavors of linux will require variations of the first command.

Windows

The easiest way to install MultiMarkdown on Windows is to download the "installer" package from the downloads page. It contains a zipfile that includes the install_multimarkdown.bat batch file. This batch file will install multimarkdown, the required libraries, and two convenience scripts to C:\WINDOWS\sytem32. I've had some trouble when installing as a user that is not an Administrator, and I've had trouble on occasion trying to run the program when not an Administrator. I welcome ideas on a better way to install the program on Windows. I also have only tested this on Windows XP.

If you want to compile for yourself, check out the instructions on the wiki.