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:
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 - 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
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.
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.
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. 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.
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.
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 - Markdown Support
Active
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
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.
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
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.
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 makrup 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.
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.
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)
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.
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 tis 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.
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.
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.
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 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. 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.
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.
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). 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.
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
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.
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 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.
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)
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.
Danger of both workflows: Overwriting
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.
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
Clarify 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.
Go to 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
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.
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 formats (fortunately with Markdown it's more difficult). No preview but works well with Marked 2. $30
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 docus). 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
Typora (free)
MarkdownPad 2 ($15) for version with table support
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.
It's really the most pleasurable of all the writers despite it's shortcomings. And the out of the box shortcomings are fixed just by downloading a better preview theme. The GitHub2 theme should really be built in and default, in the meantime. ↩︎
I've just tested this on my current MacBook Pro which it turns out I've set up differently than past MBP. Function keys work first for the system and second for applications here so this wouldn't work. In this case, Typora's Command-/ toggle is so much easier than Command-Option-P. ↩︎
Here's how the MacDown creators explain Markdown footnotes:
You don't have to use a number. Arbitrary things like [^footy note4] and [^footy note4]: will also work. But they will render as numbered footnotes. Also, no need to keep your footnotes in order, I will sort out the order for you so they appear in the same order they were referenced in the text body. You can even keep some footnotes near where you referenced them, and collect others at the bottom of the file in the traditional place for footnotes. ↩︎
Markdown Editors Shootout: Support for Tables, Footnotes, Strikethrough
Post from: Foliovision