Top Scoops

Book Reviews | Gordon Campbell | Scoop News | Wellington Scoop | Community Scoop | Search


Ten years of Markdown and iA Writer

It may not work for everyone, but switching Microsoft Word for a Markdown editor boosted my productivity.

Almost every post written on this site over the last 13 years was written using Markdown.

If we want to be technical about it, Markdown is a simple, lightweight markup language.

At a pinch you can write Markdown using a plain text editor. It is better when you use an app. My favourite Markdown app is iA Writer.

Swiss Army knife

Microsoft Word is the writing equivalent of a Swiss Army knife. It aims to cater for every possible need.

In comparison, Markdown and iA Writer are like one of those extra sharp Japanese cooking knives.

They do far less, but what they do, is done better with greater efficiency.

If you don’t know what life will bring you, the Swiss Army knife makes sense. But a chef would choose the latter to prepare a meal.

Simple, minimal, that is the whole point

The beauty of Markdown is there are a mere handful of commands to remember. There are few features.

That is a good thing. It means you can focus on writing words. Nothing else.

In this sense it is the closest thing to using a typewriter.

A few good commands

You can type out the commands for, say, bold text. That would be a couple of * symbols before and after the words you want in bold.

In a Markdown app you could also use Command-B (on a Mac) and the symbols are inserted for you. That’s the same code used in word processors like Microsoft Word.

This means there is almost nothing new to learn. You can be up and running with Markdown immediately.

Zero distraction

The advantage of this simple, minimal approach is you are not distracted by things that don’t matter.

There is no dithering over font choices or layout options.

Trust me, you can spend hours wondering if that editor waiting for your latest story prefers to get copy in Arial or Times Roman.


Simple means fast. A moment ago I fired up Microsoft Word on my state-of-the-art Apple M1 MacBook Air.

The app took three minutes to check for and download upgrades. Then it did something in the background before opening.

There are times when I have waited much longer to get started.

A Markdown editor is there immediately with a blank page ready to go.

Sure, there are times when I use Word. I have clients who expect to receive Word files or Google Docs. It can be easier to go there from the outset.

That said, converting Markdown to Word or Google Docs is no more than a mouse click away.


Markdown has another advantage. It is all about text.

If, like me, you can touch type, it means you can spend more time with your hands on the keyboard and less time mousing.

I find that over time Microsoft Word needs extra mouse activity - or touch screen action. That can give me overuse pains in my hands and arms. The more time you stay with the keyboard, the less discomfort.

It’s easy to miss this point, but if you find yourself cutting text from PDFs or web pages, pasting them into iA Writer is a cinch. Compare that with the fussiness that can happen when you past text into a word processor.

Markdown apps

Many of the posts on this site were written with iA Writer. A handful were written using Byword.

Byword is a Markdown Editor for Apple users. There is a Mac version and an iOS version that will also run on iPadOS.

iA Writer started life in the Apple camp. There’s a reason for that1.

Today there are Windows and Android versions of iA Writer.

iA Writer and Byline

For me two apps run on iOS, iPadOS, which for a long time was, in effect, the same as iOS, and they run on MacOS.

My first iOS version of iA Writer cost NZ$2.59 at the end of 2011.

It was, and remains, a bargain. That was the best $2.59 I ever spent on software. In 2016 iA charged a further NZ$5.99 for an upgraded app.

I’m not complaining. Even after buying MacOS apps, iA Writer works out at a fraction over one New Zealand dollar a year.

Phone, tablet, laptop, desktop

Because both apps store files in Apple’s iCloud, you can switch between Apple devices without missing a beat.

I can, and have, started writing on a phone, edited on a desktop, polished on a tablet and send from a laptop.

iA Writer and Byword are both solid apps. I recommend iA Writer over Byword because it has had more consistent attention from the developer over the years.

Although there is not a lot in it.

At the time of writing the most recent update of iA Writer was three months old. The most recent Byword was six months ago.

In my longer review of the latest version of iA Writer I explain why it can be better than a word processor.

Ten years on

After a decade with iA Writer, it remains my main writing app on iPhone, computer and iPad.

There are a few minor niggles. iA Writer works best for my journalism and blog posts.

Once a story needs to go longer than a few thousand words it can be unwieldy. Last year I wrote around 4000 words for a book chapter using iA writer.

If that happens, I find it best to break the text into smaller chunks.

There is no question I’m more productive with Markdown than with any alternative. I get more done with less mental and physical strain.

That has to a killer feature by any standard.

  1. Markdown has a strong Apple lineage. One of the authors is John Gruber who runs Daring Fireball, a blog about Apple products and services.

Ten years of Markdown and iA Writer was first posted at

© Scoop Media

Top Scoops Headlines


Dunne Speaks: Robertson's Budget Gamble On Treasury
The popular test of the success or failure of Grant Robertson’s fifth Budget will be its impact on the soaring cost of living. In today’s climate little else matters. Because governments come and governments go – about every six to seven years on average since 1945 – getting too focused on their long-term fiscal aspirations is often pointless... More>>

Keith Rankin: Liberal Democracy In The New Neonationalist Era: The Three 'O's
The proposed ‘New Zealand Income Insurance Scheme’ (‘the scheme’) has attracted strong debate among the more left-wing and liberal groupings, within New Zealand-Aotearoa. This debate should be seen as a positive rather than negative tension because of the opportunity to consider and learn from the implications and sharpen advocacy... More>>

Dunne Speaks: Words Matter, Prime Minister
Words matter, especially when uttered by politicians. History is littered with examples of careless or injudicious words uttered by politicians coming back to haunt them, often at the most awkward of times. During the 1987 election campaign, when electoral reform was a hot issue, Prime Minister David Lange promised to have a referendum on the electoral system... More>>

Digitl: Infrastructure Commission wants digital strategy
Earlier this month Te Waihanga, New Zealand’s infrastructure commission, tabled its first Infrastructure Strategy: Rautaki Hanganga o Aotearoa. Te Waihanga describes its document as a road map for a thriving New Zealand... More>>

Binoy Kampmark: Leaking For Roe V Wade
The US Supreme Court Chief Justice was furious. For the first time in history, the raw judicial process of one of the most powerful, and opaque arms of government, had been exposed via media – at least in preliminary form. It resembled, in no negligible way, the publication by WikiLeaks of various drafts of the Trans-Pacific Partnership... More>>

The Conversation: Cheaper food comes with other costs – why cutting GST isn't the answer

As New Zealand considers the removal of the goods and services tax (GST) from food to reduce costs for low income households, advocates need to consider the impact cheap food has on the environment and whether there are better options to help struggling families... More>>