MultiMarkdown 3 Mac Beta Available

At last, MultiMarkdown 3.5 integration is ready for beta testing on the Mac. If you haven’t beta tested before, you can check it out on this thread here:


  • Figure captions have been updated to the new MMD3 syntax so embedded graphics with captions can once again be used. Additionally you may specific captions on a line following the image, in “[Square Brackets]” instead of quotes. You can also use square brackets on the same line, as you can with quotes, with a space in between the image and the opening quote/bracket.
  • Resized images will now have their dimensions specified using the MMD method for doing so! If you have resized images in your draft and do not intend them to be resized you’ll need to revert them to their 1:1 size or re-import them, whatever is easier.
  • Scrivener now uses the referenced method for all captionable images (even if they are not captioned), with the exception of inline paragraph images that have not been resized. They will use the in-place image syntax. Images references will be placed at the bottom of the compiled document, below the collected footmarks, meaning you’ll now get a handy list of figures for your own use, in the raw MMD output.
  • Scrivener will use the MMD3 binary if one is present on your system—if not it will use an embedded copy
  • New compile pane: LaTeX Options. Provides easy one-click document class selection. In MMD 3 you need to set up several meta-data fields to change classes. In Scrivener you can just keep document specific meta-data in the compiler and let the software set up the necessary meta-data fields for you.
  • If you do not have the MMD LaTeX support package installed, the necessary .tex boilerplate files to create a ready-to-typeset document will be produced for you in the compile folder
  • Custom mode lets you type in your own boilerplate .tex into the compile pane. These will be produced as .tex files into the compile folder
  • One-click PDF output now supported. This requires a pdflatex installation. It is designed for simple error-free typsetting. If your document requires bib or glossary mid-phase work, or has halting errors in it, then it obviously won’t work for you. For documents that can be simply typeset, it should work fine. It does a 3-way run to resolve all cross-references for you and produces a single PDF file in the end with no support file clutter.
  • ODF (using Flat ODT) is now supported as a compile option. It is recommended you use LibreOffice, or a properly patched copy of OpenOffice to use them.
  • If you have any MMD2 dependent projects or, you’ll need to use plain MMD output with the appropriate option switch set in the compiler Compatibility pane (this basically just switches meta-data handling and caption output back to the old method). You’ll need to handle the conversion yourself using an MMD2 installation, post-compile.
  • If you need to use XSLT post-processing, you’ll find it available to the formats that support it in the Compatibility pane as well.
  • Preserve Formatting can now be used inline as well as for paragraph blocks (as before). When used inline to a paragraph, it wraps the text in backticks.

If you have any problems or general feedback, please post them in the beta testing forum, not here.

This is a “stable beta”. It’s been public for some time now and I use it daily for real work; but of course, always improve your backup system when using beta software.

I’ve put together a quick-and-dirty preview PDF of the new MultiMarkdown chapter from the user manual, going over the new features in detail.

URL REMOVED: See the user manual for the complete chapter, “Using MultiMarkdown”, in Part III.

A note on content: all annotations left in. Most contain platform-only text (this section is now cross-platform), but a few are tip boxes. There are a few sections that are Mac only; I just left them all on. For Windows, ignore “Preserve Formatting”, RTF, XSLT Post-processing, and Updating MultiMarkdown.

Got 404 when I tried to download the pdf above…

Same here: a 404 when I tried to download the PDF.

That was just a proofing copy. The documentation is now included in the main user manual PDF.