THIS WEEK'S SPONSOR:

Kolide

Endpoint Security for Teams That Slack - Try Kolide for Free Today!


iA Writer 4 Adds Markdown Content Blocks

A major update to iA Writer, the popular Markdown text editor for iOS and macOS, has been released earlier today. I didn’t have enough time to test the beta of version 4.0, but I’m intrigued by the idea of file transclusion – effectively, a way to structure documents with content blocks based on local file references.

From the blog post:

We’ve made a swath of improvements in iA Writer 4. The meat on the bone is this new file referencing syntax. Every file reference you insert adds a block of content to your document, be it an image, table, or plain text file. These content blocks can then be ordered, stacked and chained with ease.

We think this syntax is a natural extension to Markdown, and it would please us to see other apps use it too. We’re a bit nervous since it’s a deviation, but we’d still like to try it out and hope it finds friends. We’ve published an introductory spec on GitHub to get the ball rolling. Hopefully, content blocks based on file transclusion will become a thing beyond iA Writer. One day all Markdown editors may work like that, but, as IBM famously said, why wait?

You can reference text files, images, and even .csv files to include in the compiled text output as MultiMarkdown tables. I think this is a genius way to handle file embeds in longer documents, and it’s something I would consider for future longform projects. I’m not aware of any other Markdown text editor for iOS that implements a similar option. I’d also like to see iA go beyond local file callbacks (which only work with iCloud) and allow documents to be comprised of files stored in iOS document providers. iA Writer is one of the few text editors that fully support opening and editing files from external document providers, so extending that integration to content blocks would be the next logical step.

There’s a lot to like in iA Writer; I don’t think it’s appreciated enough by iOS power users. The aforementioned integration with iOS document providers is solid, there are several editing tools such as writing statistics and parts-of-speech highlights, plenty of output options, support for iCloud versions, and more. I hope that iA will consider adding more features to the app’s basic URL scheme in the future – one area where iA Writer is considerably behind alternatives such as Ulysses and 1Writer.

I’m going to play around with iA Writer for a while – I feel like the app deserves more attention, and I want to experiment with document providers and content blocks for MacStories reviews and our newsletters.

Unlock More with Club MacStories

Founded in 2015, Club MacStories has delivered exclusive content every week for over six years.

In that time, members have enjoyed nearly 400 weekly and monthly newsletters packed with more of your favorite MacStories writing as well as Club-only podcasts, eBooks, discounts on apps, icons, and services. Join today, and you’ll get everything new that we publish every week, plus access to our entire archive of back issues and downloadable perks.

The Club expanded in 2021 with Club MacStories+ and Club Premier. Club MacStories+ members enjoy even more exclusive stories, a vibrant Discord community, a rotating roster of app discounts, and more. And, with Club Premier, you get everything we offer at every Club level plus an extended, ad-free version of our podcast AppStories that is delivered early each week in high-bitrate audio.

Choose the Club plan that’s right for you:

  • Club MacStories: Weekly and monthly newsletters via email and the web that are brimming with app collections, tips, automation workflows, longform writing, a Club-only podcast, periodic giveaways, and more;
  • Club MacStories+: Everything that Club MacStories offers, plus exclusive content like Federico’s Automation Academy and John’s Macintosh Desktop Experience, a powerful web app for searching and exploring over 6 years of content and creating custom RSS feeds of Club content, an active Discord community, and a rotating collection of discounts, and more;
  • Club Premier: Everything in from our other plans and AppStories+, an extended version of our flagship podcast that’s delivered early, ad-free, and in high-bitrate audio.