Markdown Editors Shootout: Support for Tables, Footnotes, Strikethrough

Alec Kinnear | Foliovision

30-39 minutes


We use Markdown everywhere at Foliovision as our main project management software Teamwork offers excellent Markdown support. For some of our internal documents we desperately need tables. This was preventing us from switching everything to Markdown. I’d heard there was decent support for tables in Markdown but trying to edit Markdown tables long hand was not fun at all. This is what Markdown tables look like as plain text:

| Application - Markdown Support | Active | Preview | Price     | Non-app store version | Writing Experience | Footnotes | Strikethrough | | ------------------------------ | :----: | :-----: | --------: | :-------------------: | :----------------: | --------- | ------------- | | Typora                         | Superb |   Yes   | Free Beta |          Yes          |        ++++        | Weak      | Two Tildes    | | TableIt                        |  Yes   |   Yes   |       $19 |          Yes          |        N/A         | N/A       | N/A           | | Marked 2                       |   No   |   Yes   |       $10 |          Yes          |        N/A         | Yes       | Yes, GFM      | | BBEdit/TextWrangler            |  Yes   |   No    |  $50/free |          Yes          |         ++         | No        | No            |

So I went looking for a Markdown editor which supported tables well for my team. In the process I discovered a lot about Markdown and even editing. I invite you to join me on my journey. As I use OS X and most of our team does as well (we have some Linux and a few Windows users: we have fewer people using Windows than Linux at this point), this article focuses on OS X Markdown editors. Our overall winner is a cross-platform application (OS X , Windows, Linux) built on HTML5 technology and we do cover other Windows Markdown editors at the end of the article.

First let’s start with some tables. There are two tables in this article (originally I had one). The first table are dedicated table tools or preview applications. The second table is a list of Markdown applications ranked in my order of preference as a writing tool. If I didn’t have to publish to web or email regularly (priority on HTML preview) my rankings would probably change with some of the single pane Markdown editors doing better. Typora is the only application which appears on both lists. This is because Typora is both a great table creator/manager (won that category) and a first rate single pane editor (won that subcategory).

Markdown Table Tools

Application Table Creation Table Preview Price Non-app store version Writing Experience Footnotes Strikethrough
Typora Superb Yes Free Beta Yes ++++ Weak Two Tildes
TableFlip Yes Yes $19 Yes N/A N/A N/A
Marked 2 No Yes $10 Yes N/A Yes Yes, GFM
BBEdit/TextWrangler Yes No $50/free Yes ++ No No

Dedicated Table Tools

TableFlip seems useful with tables at first glance. You can import Markdown tables from the clipboard. I didn’t see a tool to automatically convert the table to HTML. The auto growing columns is fantastic. It’s possible to work on a really wide table in TableFlip like a spreadsheet.

TableFlip-sample-table
TableFlip-sample-table

What TableFlip is missing though is a way to copy and paste whole rows. I wanted to reorder the table attached to this document. Tableflip didn’t let me do it: you can only copy one cell at a time. To do what I want to do you have to open your table in a text editor like BBEdit and do your copy and pasting of rows there with preview in TableFlip. This makes TableFlip only marginally more useful than Marked 2. It gives you awkward access to two sets of tools. TableFlip does not allow you to move columns either. I hope you designed your table right the first time, as BBEdit can’t help you move columns either. I would specifically like to swap the Strikeout and Footnotes columns and have no way to do so.

At the current price point of $19 I’d expect to at least be able to drag and drop reorder rows in TableFlip. Typora plus BBEdit plus Marked 2 doesn’t sound any worse.

TableFlip does handle multiple tables in document very well, putting them into multiple tabs and ignoring the non-tabular data.

Typora is a full-fledged editor (and I’ll review that aspect in context below) but Typora is the only other tool with a really good table creator and editor, in some ways better than even TableFlip. Certainly, the Typora table editor is prettier. At all times, you can add rows and columns and while in preview mode change column alignment. It’s nearly impossible to move rows around though. You need to open your document in BBEdit, TextWrangler or some other code editor to effectively move rows.

Typora in table editing mode
Typora in table editing mode

Marked 2 is not a composer but a preview window. It’s very powerful, allowing you to choose flavours of Markdown and whether to turn on syntax highlighting or not. If you have a beloved code editor (bbEdit, TextMate, vim, SublimeText) with all your keyboard shortcuts, then Marked 2 is a very useful tool indeed. It’s table preview is excellent. There’s slight differentiation of background shades making it easier to read.

Simple table previewed in Marked2
Simple table previewed in Marked2

Unfortunately Marked 2 fails on complex tables with Markdown syntax inside (even simple asterisks). So does Typora though under some circumstances (five asterisks). TableFlip, LightPaper and Mou are resilient enough to stand even the asterisk torture test, differentiating between a table cell and normal text area. I finally gave up and used plus signs instead, even though they are harder to read.

Marked 2 can be confused by nested Markdown signs within table cells
Marked 2 can be confused by nested Markdown signs within table cells

BBEdit/TextWrangler both come from BareBones a venerable Mac publisher. I own and use BBEdit myself. For just Markdown tables use, there’s zero reason to buy the full BBEdit (which is a wonderful development tool with great HTML preview tools). BBEdit’s Markdown preview is very weak (a late, half-hearted addition). Effectively the two apps are interchangeable as Markdown table row editor.

Clean preview in BBEdit lets you just copy and paste Markdown table lines, even long ones
Clean preview in BBEdit lets you just copy and paste Markdown table lines, even long ones
To see the nitty-gritty, just turn on invisibles
To see the nitty-gritty, just turn on invisibles in BBEdit

Markdown Writing Tools

In this next table dedicated to editors, dual pane editors come first and then single pane editors. Within the groups, applications are listed in order of the quality of writing experience. There is additional scoring for strikethrough and footnotes. The higher a tool is on this list, except for the first three, the more I like it. I might just make two tables instead.

Markdown Editors Rated for Table Support and Writing Experience

Application Table Creation Table Preview Price Non-app store version Writing Experience Footnotes Strikethrough
iA Writer Weak Yes $10 No +++++ Yes Two Tildes
MacDown No Yes Free Yes +++++ Yes Two Tildes
Mou 0.8.7 and .6.6 (Snow Leopard) No Yes Free, $15 Yes +++++ Yes Two Tildes
LightPaper No Yes $13 Yes ++++ Yes Two Tildes
Mailmate No Yes $50 Yes ++++ Yes No
Typora Superb Yes Free Beta Yes ++++ No Two Tildes
Teamwork No Yes $149/month Yes +++ No Two Tildes
nvalt No Yes Free, $20 Yes ++++ Yes No
Writeapp Weak Yes $5 No +++ Yes No
Byword No Yes $15 No +++ Yes No
TextNut No No $25 No +++ Non-standard Yes
Caret No Yes $12 No +++ Weak Yes
MultiMarkdown Composer No Yes $5 No ++ Yes, non-standard No
Ulysses 3 No No $45 No ++ Non-standard Pipes, no preview
Focused (originally Typed) No Yes $30 Yes +++ No No
MarkMyWords No No $15 No + No No

Dual Panel Editors (Markdown + Preview)

Mou doesn’t have a wizard to add tables but does a great job letting you preview tables. Even editing a simple table is not particularly difficult in Mou. Complex tables are quite hopeless though.

Mou is great to work with Markdown tables until you get to really wide ones
Mou is great to work with Markdown tables until you get to really wide ones

iA Writer only lets you add tables, not edit or add to them, unlike Typora. The table preview is hard to read in its default setup (no column demarkers). Curiously enough iA Writer was one of my favorite Markdown editors until this exercise as you can have a huge composing interface with a small preview. The sync scroll is the best as well. The dark theme is delicious and easy to get to. What I really like is that it’s possible to have different widths of writing and preview columns and that text adjusts size automatically as you move the column delimiter. This means I can enjoy a large composing typeface than the one in which I preview. 1

Out of the box table preview is terrible in iA Writer. Download and change preview theme for improvement
Out of the box table preview is terrible in iA Writer.
Download and change preview theme for improvement

I ran into some other limitations with iA Writer while writing this article. Typora, Byword and Mou do a much better job of handling nested quotations than for example iA Writer (my main writing tool). This oversight and better table preview might make the indefatigable Mou my main writing tool again. Discovery: By changing the template to iA Writer’s free downloadable GitHub preview, both tables look much better as do nested quotations. It’s strange that iA writer ships with a not very capable default preview theme.

MarkMyWords is a powerful but ghastly ugly relic (just check out the icon) of another era of software development. Why you might like it? Why I liked it at one time: Textile support and Textile conversion. We used to use Basecamp Classic and Textile was a second mother tongue to me. We also had some older longer posts to convert. Later we built Pandoc Online for better conversion of Textile to Markdown and Markdown to HTML and back.

MarkMyWords suffers from strange and awkward aesthetics. If you'd like to work in other markup languages than Markdown, MarkMyWords offers the widest choice.
MarkMyWords suffers from strange and awkward aesthetics. If you’d like to work in other
markup languages than Markdown, MarkMyWords offers the widest choice.

Mailmate is a fantastic power user’s email client which wraps the best characteristics of Eudora and Apple Mail of Snow Leopard vintage in a single geeky package. The writing markup language of Mailmate is either Markdown (plaintext is also available of course). Markdown table preview is surprisingly capable. If you are a mailcentric person who uses Markdown you owe it to yourself to give Mailmate a chance. I just wish it was a little less expensive. I picked it up on a sale. Even at full price though Mailmate is worth it. Benny goes years between charging for updates.

MailMate offers full Markdown table support, with footnotes as well.
MailMate offers full Markdown table support, with footnotes as well.

nvAlt is actually notetaking software from the author of Marked 2, Brett Terpsta. While I wouldn’t compose long Markdown documents in nvAlt as a first choice, it’s great to have a notetaking application which can handle Markdown with preview. While nvAlt can handle basic tables, it fails on sophisticated tables in the same way as Marked 2.

Normally one would not use nvAlt in full screen with large preview. But nvAlt is capable if called upon.
Normally one would not use nvAlt in full screen with large preview.
nvAlt is capable if called upon.

LightPaper is very similar to Mou for pay. LightPaper separates the writing and preview windows forcing a lot more window management on the writer. LightPaper does handle tables well (there’s no table generator built-in but it will send you to one).

LightPaper has excellent table preview with horizontal scrolling on wide table. No built in table tools though.
LightPaper has excellent table preview with horizontal scrolling on wide table.
No built in table tools though.

Caret is 122.7 MB while Mou is 7.4 MB and iA Writer is 19.7 MB and even Ulysses is 34.5 MB. Very inefficient. Footnotes can’t have paragraphs or blockquotes. Single document only. It’s a pity as their website is beautiful. Relatively high CPU usage when in use with slow drop. It’s difficult to recommend Caret in comparison to the competition.

Single Panel Editors

Typora, Writeapp, Byword and Focused all belong to a category where you have to press a keyboard shortcut to preview your Markdown. When in preview mode, you cannot edit your text at all. Typora manages to break out of that awkward paradigm by allowing you to edit when in preview mode. The writer is encouraged to write all the time in preview mode, only switching to Markdown code view in the case of difficult formatting. I still prefer to write in code view with a preview handy. Seeing one’s writing in two typefaces with the markup code always visible lets you proof your copy as you write. Toggling preview on and off which is a very slow way to work if you have a lot of links and formatting (you can’t check anything until you finish the document.

Typora preview is beautiful but flipping back and forth to source mode is not efficient
Typora preview is beautiful but flipping back and forth to source mode is not efficient

Workflow in all of these single panel apps could be improved by moving the preview functionality to a non-modifier driven (let alone the painful dual modifier driven Option-Command-P required by Byword and Writeapp and Focused) such as F1. You can do this yourself using System Preferences > Keyboard > Shortcuts > App Shortcuts or the excellent OS X macro program Keyboard Maestro but the authors of these programs should have thought of this themselves (if any of them are reading, just add a preference: “Also use F1 to toggle preview”).2

Writeapp does have preview window option, but its preview jumps all over the place with tables in the preview. Generally the preview window shudders when typing which would make it impossible to use over the long haul. This would be a bug easily enough overcome but apparently Write is no longer in development. A pity as Writeapp publishes to Tumblr and WordPress out of the box. It also enjoys the most elegant default theme (you can only have one but it’s easy to customise). Due to the broken preview, Writeapp is evaluated as a single pane editor.

Writeapp very pretty preview shudders while typing. Unusable.
Writeapp very pretty preview shudders while typing. Unusable.

The Typora writing experience is way ahead of Writeapp or Byword though. What’s special about Byword is its ability to publish directly to WordPress, Medium, Tumblr, Blogger and Evernote. Byword on the other hand can’t copy a text selection to HTML. It’s all or nothing. Byword is also low contrast with no way to change that. Low contrast applications are the bane of modern design.

Fast track publishing to multiple platforms is a great feature.
Fast track publishing to multiple platforms is a great feature.

Focused is another really pricey alternative at $30/license. It seems to be an overpriced version of Ommwriter with Markdown. Focused only offers single pane view w/toggle to Markdown. Awkward (far more so than Typora). Weird hideous icon. Strange product. Apparently it used to belong to RealMac software (makers of RapidWeaver) who have a history of creating and disposing of applications. Caveat Emptor. While Focused gets writing experience marks thanks to its music themes, it falls further in ratings due to its lack of support for both footnotes and strikethrough.

Focused in text mode. Nothing special.
Focused in text mode. Nothing special.

Ulysses strangely as the most expensive of these applications at $62 CAN cannot compose or preview tables (well unless you create them in HTML and wrap them in HTML blocks and then export as HTML – your tables won’t even show up in a PDF version!)

And here is an example of a Raw Source block, which inserts a table when exported as HTML (and just vanishes when exported as PDF):

Ulysses doesn't offer preview but coloured markup.
Ulysses doesn’t offer preview but coloured markup.

Ulysses also hides your documents in its own custom folder and forces you to use iCloud more or less. The preview syntax and colouring for me is just weird.

Ulysses-theme-preferences
Colours, colours everywhere.

Far from being a writer’s instrument, it seems like an aesthetic torture chamber. Instead of just allowing you to write and preview your document everything is colour coded. In Ulysses favour are complex and useful typewriter and focus modes which emulate the concentration of working on a typewriter.

  • Highlight fades out everything but the current line, sentence or paragraph, respectively.
  • Fixed Scrolling (also known as typewriter scrolling) keeps the line you’re currently typing in vertically fixed on your screen. It is available in several variants.
  • Mark Current Line highlights the line you’re currently typing in.
Ulysses typewriter mode is impressive.
Ulysses typewriter mode is well thought out

The built-in help and walkthrough is impressive. It really shows you that difficult to use software can be made easier to adopt, via post-sales training and selling within the application. The Ulyssses weblog with real writers’ stories is also impressive.

There is no way Ulysses offers value for $60 in comparison to the other tools we’ve seen here from free to $20. Ulysses would be my least favourite day to day editor. On top that Ulysses is the least capable advanced Markdown editor. It only clear strength seems to be better templating options for PDF output (HTML output’s final appearance is dependent on your website stylesheet not that of Ulysses).

Teamwork is our main project management software which we use every day in Foliovision. There’s Markdown support in Messages, Comments and Notebooks. Here I’m referring to the Notebook support. It’s not dual screen but there’s a built-in preview tab which makes it easy to proof your work. Teamwork did not break the table but the rating asterisks were heavily edited from a five star system to a two star system. This is the same indicator which broke Marked 2 and nvAlt so if I put in numeric ratings the table support would be flawless. Does not support footnotes at all though. I’ll encourage Teamwork to add footnote support.

Teamwork Markdown support and preview is excellent, allowing a single working environment
Teamwork Markdown support and preview is excellent, allowing a single working environment

For an application which supports Markdown reluctantly (I was one of the clients pushing Teamwork for across the board Markdown support), Teamwork does awfully well in providing a useable and resilient Markdown environment. Having the same markup language across all our projects improves our company workflow enormously.

TextNut suffers from the same weird library nonsense which Ulysses has. It’s very difficult to even get a file into Marked 2 for preview. The icon is annoying. Very powerful focus, typewriter and zen options for writers who appreciate that sort of thing (right now I’m typing happily away in iA Writer and very happy to be able to see the full text of my page. I’d kind of like to have a horizontal cursor to emulate the old terminal mode more but I can live without that: when editing a vertical cursor is better in any case). The visual markup like Ulysses is both colourful and distracting (H4 headers are marked at both H4 and with four hashtags, as opposed to iA Writer where you get just four hashtags aligned right in the left hand margin allowing a writer to read straight down the page).

TextNut's preview mode cannot handle tables at all
TextNut’s preview mode cannot handle tables at all

Unique is a medium style formatting bar which pops up whenever you select text and gives you mouse access to the basic and the more complex Markdown styling options. While the formatting bar looks great, With your primary writing tool you should be using keyboard shortcuts so it’s a bit of a distraction. Unique and cool is a formatting clear option in the menu.

TextNut's somewhat unique formatting bar, something like Medium
TextNut’s somewhat unique formatting bar, something like Medium

The rich text mode looks much clearer and includes most of the same shortcuts. Footnotes get moved to the bottom when you switch between Markdown and rich text mode which is okay, except…unlike all the other applications which support footnotes, when copying footnotes into HTML TextNut creates divs instead of a numbered list. Varying the HTML code brings formatting and compatibility worries when pasting to a website. TextNut is just too hard to use unless a writer really wants libraries and pop-up formatting. I still don’t understand the benefits of the RTF writing environment with two document formats. Sync and conversion is difficult: it would be much better to pick a master format and stick to it. Creating alternative formats on export makes a lot more sense to me. That’s the way Typora does it. Typora’s preview mode looks a lot like TextNut’s RTF mode and there’s no format conversion between them.

Extra Features

This is an explanation of each additional column in my ratings table above.

App Store

I don’t like app store apps much. The app store is subject to state spyware (if Apple is asked to embed code in an app, by US law Apple must do so). Your apps could just stop working. I much prefer direct purchase from the vendor. Unfortunately in the Markdown space, many apps are only available in the app store. Out of the Markdown editors which I care about, only iA Writer is app store only so there are lots of non-app store options.

Footnotes

I don’t use official Markdown footnotes when writing ([^2]for example), instead creating footnotes by hand with round brackets and writing them at the bottom. Ideally I’d like to be able to use Markdown footnotes usefully at some point. Thanks to this review I now do use regular Markdown footnotes and know which apps support them. For my reference and yours, support for footnotes is included in the table. Our overall winner in the table sweepstakes, Typora, has very poor footnote support ironically.

One of the best footnote implementations comes in MacDown (a clone of Mou in active development) who take the time to document how to use Markdown footnotes well.3 On the other hand, MacDown can’t handle a simple dollar sign within text without turning the following text green.

MacDown does well on footnotes but a simple dollar sign breaks syntax
MacDown does well on footnotes but a simple dollar sign breaks syntax

Typora’s footnote support is next to useless (basically Typora just renders superscript from the footnote syntax. It’s up to the author to number and position his footnotes himself. Typora stays on top of this ratings table thanks to its extraordinary table support but its failings with footnotes takes it out of the stakes as a serious daily Markdown writer unless you really like single pane with hot key preview. iA Writer enjoys superb footnote support.

IA Writer handles footnotes really well. You can create your footnotes within the article and they turn up at the bottom automatically.
IA Writer handles footnotes really well. You can create your footnotes within the article
and your footnotes then turn up at the bottom automatically.

Strikethrough

For me, strikethrough or strikeout is one of the more useful commmunication signals around. I often have an idea which I reshape to be better but I want my readers to know that I had the original idea and scratched it. Strikethrough is a bog standard HTML tag (<del></del>)so by rights should really be in Markdown. Curiously, the best of these editors offered a simple strikethrough syntax. Marked 2 does not offer strikethrough out of the box ([change parser to Discount/GFM](change parser to Discount/GFM) for it to preview properly. I will ask Benny at Mailmate to add two tilde strikethrough.

Workflow

Early on in this article, I planned to propose Typora, TextWrangler (or BBEdit) as the ideal workflow for creating and editing complex tables. One would use Typora to create the tables and BBEdit to handle complex editing operations. Typora plus BBEdit (be sure to turn off softwrap) will let you do almost anything you need with a Markdown table. If you have a really wide table the preview isn’t great (sometimes individual letters will flow over to the next row; Mou handles this better as does Marked 2 which could be added to this workflow for better preview of both tables and footnotes).

Typora is still the best Markdown editor to create and edit tables. Once your basic tables are done, whether you prefer to edit your document in Mou or Typora is a subjective question. I’d rather be working in a two pane editor like Mou, MacDown or iA Writer. In any case, complex table editing (moving rows) really must be done in BBEdit (or TextWrangler) with softwrap turned off. Add Marked 2 to main Typora workflow for better table and footnote preview. But that makes for a complex workflow (three applications: Typora, TextWrangler, Marked 2).

Cost: free to $25 (Typora is beta, Mou is $15 donationware, TextWrangler is free, Marked 2 is $10: I’ve donated to Mou)

Alternative Workflow

If you do a lot of work with tables and like to write in Markdown, TableFlip is an equally powerful table tools as Typora. Until you can drag and drop rows with TableFlip I wouldn’t consider it an essential tool as long as Typora is there to help you create tables and choose alignment for your columns. Complex table editing (moving rows) will still require a trip to BBEdit. A great dual pane editor like Mou or MacDown or iA Writer plus TableFlip and TextWrangler would be even more powerful than Typora plus TextWrangler/BBEdit.

Cost: $19 to $34 (TableFlip is $19; Mou is $15 donationware, MacDown is free, iA Writer is $10; TextWrangler is free).

Table Conversion to HTML

Curiously Mou is the only one of the applications supporting tables who use old style HTML alignment (<td align="center">) instead of style tags (<td style="text-align:center;">) for alignment. It makes for a much smaller and more readable table and even one which is easier to style subsequently (or clean). FYI, TableFlip cannot export tables as HTML on its own, it needs a helper to convert to Markdown table to HTML. As you’ll be writing in a helper anyway I don’t see this as a serious workflow issue.

If you ever want to convert HTML tables to Markdown tables for editing before moving them back to HTML tables for publishing, Dom Christie has published a fantastic online HTML tables to Markdown tables tool which worked well in my testing.4 Donat Studios has built an excellent CSV to Markdown Table converter which passed testing as well. Both scripts are on GitHub with an MIT license so feel free to incorporate or extend them in your own tools.

It’s so much easier to build footnotes within Markdown that this is a strong argument for a 100% Markdown workflow (we haven’t managed it for our articles in WordPress as we publish some demos which just don’t fit within Markdown.

Danger of both workflows: Overwriting, Losing Data

Be very careful with including TableFlip in your workflow saves your whole document as soon as you even click into any table cell and Mou or Typora will lose any changes made since its last save. Typora does not autosave. You must save manually before switching to TableFlip. BBEdit will usually warn you about unsaved changes when you move your focus to its version of the document if there are changes on the document on disk and to the BBEdit version.

BBEdit will warn you reliably
BBEdit will warn you reliably
TableFlip's warnings are a bit less reliable
TableFlip’s warnings are a bit less reliable depending on the partner application

Just now Typora and TableFlip were in conflict over a file freezing both of them. After force-quitting TableFlip, Typora recovered and I was able to save the document normally (I’d copied source ahead of time just in case). As every writer knows even losing a single paragraph and reconstructing it, takes the flow out of writing and makes for longer, less productive days. Having endured conflicts with Typora and TableFlip all open losing some text, if I were to use a Typora to create tables while doing the main edit with another Markdown application I would edit the Markdown tables in a separate document in Typora and paste them back in just before publication.

Separate documents is a slower workflow so I’m planning to use iA Writer and TableFlip to build my own tables in the future. While I finished the article in iA Writer and TableFlip, I did write most of this article and edit most of the large table at the top in Typora. Both workflows are equally viable. iA Writer and TableFlip has the added advantage over Typora of allowing me to edit tables without losing my place in my main editor while writing.

Like TextWrangler/BBEdit, iA Writer co-operates well with TableFlip so it’s safe to use iA Writer and TableFlip together (iA Writer seems to autosave when moved to background focus) but I’m likely to press the save key before switching to TableFlip anyway out of caution. I still have to do some more testing with iA Writer plus TableFlip plus BBEdit to able to feel really comfortable. Unlike iAWriter, BBEdit does not autosave on changing applications so there’s a much bigger chance of making a change and ending up with two versions or lost text. It’s probably best to open your Markdown document in BBEdit when you need to move rows and otherwise work in just iA Writer and TableFlip.

As an integrated two application system keeps workflow simpler and faster, iA Writer (or MacDown) and TableFlip sounds like the ideal Markdown workflow for people who need tables. If you’d like to go free and don’t do much with footnotes, just Typora is a great second choice.


Markdown tools not covered

Recommended OS X Markdown extras

  • If you are using Markdown a lot, make sure to go by QLmarkdown to grab a QuickLook plugin for Markdown. Working in El Capitan. Just drop it into /Users/~/Library/QuickLook. Create the folder if you have to. To get to your user library quickly, hold down Option and choose Go > Library in the Finder to reveal the user’s hidden Library. Alternatively you can move it into the main system library (for all users) but you’ll have to use the terminal in that case (permissions). Works great. Tables usually work (not always). Images are broken even with correct paths in El Capitan due to QuickLook sandboxing. You can change text size by editing the styles.css file inside /Users/~/Library/QuickLook/QLMarkdown.qlgenerator/Contents/Resources/styles.css
  • Clarify 2 lesson builder. Exports to Markdown: export is clean and logical but non-configurable (you could add a script). Excellent tool for quickly creating documentation. Markdown editors don’t handle images all that well. Clarify does. $30 ($15 upgrade). Clarify 1 does not have export to Markdown. Not interesting. It is possible to customise the Markdown export via XML.
  • iThoughts X is mindmap software with Markdown text editing (including via copy and paste from other apps). Markdown here is surprisingly useful in mindmapping software. iThoughts X is very powerful but not as attractive as MindNode Pro. Powerful but at a price. $50.
  • FoldingText. Another outliner style Markdown editor. Hog Bay Software builds and ends of lines products. I bought WriteRoom, Hog Bay Notebook, TaskPaper. Maybe even Mori. The notebook became Mori, a kind of vaporware. FoldingText looks like what Hog Bay Notebook should have become. Be forewarned: if you like the software the way it is buy it. Jesse Gros Jean does not have a long attention span and changes file library structure and formats (fortunately with Markdown it’s more difficult). No preview but works well with Marked 2  $30. More info.

NoN-recommended OS X applications

  • Erato. Not for sale while v2 is being developed. Now that’s a weird and not very good position. Nice icon though.
  • Whiskey. Only made it to Beta. There’s some videos.
  • Highlights App. Workflow is a bit complicated but basically allows you to extra all your highlights from a PDF into a single Markdown document. It might almost be easier to copy the highlights as you go unless you are reading on an iPad. Complex and fiddly. If you need it, you know who you are. $30
  • Hemingway Editor. For the illiterate (and non-native speakers) who can’t build correct sentences. $20
  • Texts.io. An interesting idea and a very elegant toolbar fall down on rather poor Markdown conversion coming and going via copy and paste. Nominally great table support is useless as the tables are mangled on import and export. Very peculiarly comes with hard wrapping on save enabled by default. The problem is not the price but the execution. $19
  • Markdown Pro. Single page website full of hype. Talking about how great Mavericks is. Support only via email (no docs). Out of date software with a price tag, app store only, no thanks. $10
  • Touch Dream App’s Markdown. Doesn’t open on latest OS, won’t save in .md format, Developer’s site is Wix subdomain. Fourth most popular product in the app store on search for “Markdown”. How is it that Apple allowed this punk to run off with John Gruber’s trademark name for an app which just makes people angry and hate Markup. $9 for something worse than almost anything on this list.
  • MarkdownD. Another big toolbar version, but this time dual pane with preview. Using the buttons gets you multiple Markdown header levels, not changing the existing one. Is not and does not feel like native Mac app. The settings keyboard shortcut doesn’t work. Does handle tables well with full support for GitHub flavoured Markdown. Yes for Strikethrough, no for footnotes. Clumsy way to waste $16
  • Writed. Does not bring anything special to the table. Can’t preview tables. The export packs for print and PDF are $3. But why buy this one? There are better Markdown editors for free. There’s a pro version which doesn’t seem to do anything more but is now $9 instead of $3 for an export pack.
  • Gone: Writedown, but replaced by a Chinese $3 version which doesn’t seem to do anything special.

Windows Markdown editors with good table support

  • Typora (free). Covered in detail above. Highly recommended.
  • MarkdownPad 2 ($15) for version with table support. Free version does not offer any of the advanced features.
  • Haroopad (free and cross-platform). Annoying blue rooster icon. No footnotes, support for strikethrough. Footnotes don’t work unless manually put at the bottom. Passive support for tables. Just cuts off wide tables in preview. Includes three column preview. Aesthetically not very Mac. Vim mode is a plus.
  • Caret. Covered above. Cross-platform. Not recommended on OS X due to inefficient resource usage on. Perhaps the Windows version is better. The competition is less stiff.

Alec Kinnear

Alec has been helping businesses succeed online since 2000. Alec is an SEM expert with a background in advertising, as a former Head of Television for Grey Moscow and Senior Television Producer for Bates, Saatchi and Saatchi Russia.