This Week's Sponsor:

Winterfest 2024

The Festival of Artisanal Software


Posts tagged with "markdown"

Pretext: Files-Rooted Simple Markdown for iOS

Last month I was delighted to discover a new plain text editor for iOS, Textor, that focused simply on the basics of text editing. Though I valued Textor’s minimalism, one feature I did miss was support for Markdown styling. This hasn’t been added to the app since then, but fortunately, I no longer have to wait for it; a new app just launched that’s essentially Textor with Markdown, and its name is Pretext.

Pretext integrates directly with iOS 11’s Files app, making it easy to create or edit Markdown and plain text files stored across any of your file providers. Open the app and you’ll see a document browser for choosing a file to edit; alternately, you can create a new file by hitting the plus button in the top-right. If you’re creating a new file, Pretext asks you to set a file name, with the option of automatically prepending the date to it, and you can choose to make it either a .md or .txt file.

While the simplicity of Pretext’s “just you and the text” environment is its greatest strength, the app does offer a few specific features that are of benefit to Markdown writers especially. First is the great keyboard shortcut support: all the basics of Markdown syntax can be done with a quick shortcut, including tasks like link insertion; because of this, Pretext offers one of the most efficient means of adding links to an article. The remaining few features of the app are found by hitting the share icon during editing, which offers access to the share sheet, the app’s settings screen, and previewing your Markdown file as HTML – the latter is especially useful for anyone who publishes their work online. Options in settings include tweaking the text size, switching themes from light to dark, and a couple alternate app icons.

I’ve been using Pretext in beta for the last few weeks to edit Markdown files shared by other MacStories collaborators in Working Copy, and the app has been exactly what I need. I can open Pretext, make my edits aided by visual Markdown styling and keyboard shortcuts, and preview the finished product as HTML. All changes are then saved directly in the file’s source.

Pretext is a simple utility, and isn’t going to replace Ulysses for me as a daily driver, but for some people it legitimately could. Too often writing apps are overly complicated, and Pretext focuses on offering just what a writer needs: space, and a few key tools to aid the writing process.

Pretext is available as a free download, with a $0.99 In-App Purchase unlocking the app’s dark theme and alternate icons.


Bear 1.4 Brings Tag and Note Autocomplete, True Black Theme for iPhone X, and More

As I noted last month in my iPad Diaries column, I’ve started using Bear in addition to Apple Notes to research articles in Markdown and later convert them to drafts in Ulysses. I was impressed with Shiny Frog’s work on iOS 11 and how they brought advanced drag and drop to Bear, but I’m even more positively surprised by the improvements to tagging they released today as part of Bear’s 1.4 update.

Read more



Ulysses 12: Writing on iOS Has Never Been Better

This summer Ulysses announced a major business model shift, with its iOS and macOS apps moving from up front purchases to subscription supported. As tends to happen, the move stirred up some controversy. In my mind at least, the company’s reasoning was sound – as the app’s co-founder stated, “Writers want to rely on a professional tool that is constantly evolving, and we want to keep delivering just that.”

Today brings the first major update to Ulysses following its switch to subscriptions. Bolstered by Apple’s recent focus on evolving the iPad platform, Ulysses 12 is primarily an iOS release; while the Mac version gains some improvements, it clearly isn’t the centerpiece here. Ulysses on iOS gains drag and drop support, multi-pane editing, streamlined library navigation, and image previews – all of which make an already powerful writing tool even better.

Read more


NotePlan Calendar + Markdown + Notes Comes to iOS

When I first heard about NotePlan, I was intrigued. It was a Mac app that used a text format (Markdown) as a calendar-based system, a note for each day, allowing you to easily create tasks and take notes, then see it all in an organized calendar. NotePlan for iOS was released today, and it’s enough to sell me on the idea.

I have a lot of side projects (I suppose my whole life is side projects these days), and organizing todo lists is vital. I love using the TaskPaper format, with TaskPaper on Mac and Taskmator on iOS, to track action items for individual projects. I also have a calendar, and a bucket of notes. Combining all of this in one place is appealing to me, and being able to use it on both Mac and iOS makes it truly useful.

In NotePlan, tasks are created as Markdown lists. You can have it recognize any list item as a task, or tell it that only lines with a checkbox (- [ ] Thing to do) are action items. There’s an extra keyboard row available when editing that makes it easy to create items, complete or cancel them, or even schedule them for a future date.

Tasks can sync to Reminders lists as well, so it can incorporate into other workflows (and even shared lists). In the calendar view you can tap a day to see the note and associated task lists for that date.

Each day on the calendar gets a note, and you can add freeform notes in the All Notes area. A note can be bits of information, its own action list, or both. You can use #tags anywhere in the notes to organize, and wiki style links ([[title]] or [[YYYY-MM-DD]]) to reference other notes. Tasks added to freeform notes can be scheduled to the calendar with a tap, so you can use notes as a central project repository and schedule out the day’s (or week’s) tasks as you’re ready to tackle them.

NotePlan on iPhone

NotePlan on iPhone

On the new iOS version, you can drag and drop tasks around by pressing a text block until it turns blue and sliding it into place. You can also press and hold until it turns blue, then release and press another one to expand the selection between them, at which point NotePlan will offer you a toolbar to allow batch completion, rescheduling, etc.

I’d label NotePlan as a day planner, not a task manager like OmniFocus or Things. It’s ideal for planning out your day, Bullet Journal style. You won’t find extensive project management features or perspective overviews, but the combination of scheduling, tagging, and (plain text, portable) notes in one place makes it a true productivity tool.

If words like productivity, GTD, Markdown, TaskPaper and Bullet Journal cause a stirring within you, you’re probably the right audience for this one. Check out NotePlan for iOS, and then try out the Mac version for fully-synced productivity. Today and tomorrow, NotePlan for iOS is $11.99. After that, the price will be $14.99. NotePlan for Mac is $16.99.



MindNode for iOS Adds TextBundle Export Option

I’ve long been using iThoughts to create mind maps for my longform stories, but I’ve been playing around with the latest MindNode for iOS over the past couple of weeks, and I’m intrigued. MindNode 4.5 for iOS adds the ability to export mind maps as TextBundle archives (more precisely, the compressed version called TextPack), which can then be opened as rich documents in Ulysses.

Launched three years ago, TextBundle is an archive format designed to let Markdown text editors exchange text documents that also contain referenced images. Ulysses, my favorite text editor, fully supports the TextBundle spec, along with the popular Bear and Marked. With the latest MindNode 4.5, this means you can now create a mind map that contains sub-nodes, inline images, and notes, export it as TextBundle to Ulysses (or other apps), and you’ll end up with a Markdown-formatted sheet that retains inline attachments.

A mind map with an image becomes a sheet in Ulysses thanks to TextBundle.

A mind map with an image becomes a sheet in Ulysses thanks to TextBundle.

While writing in plain text with Markdown formatting is fantastic for file portability, there’s the downside of .txt files not being able to act as containers of other referenced files (such as screenshots). Ulysses’ unique handling of sheets breaks with the tradition of plain text files, but it enables for powerful additions to standard Markdown editing, including notes, keywords, and images. I’ve been writing in Ulysses for over a year, and its non-standard approach to Markdown hasn’t been an issue because every time I publish a story or save a draft for a document I’m working on, I also save a second copy of the same file as a regular .txt in my Dropbox. This way, I enjoy the best of both worlds – Ulysses’ richer editing environment, and the portability of plain text files synced with Dropbox.

With MindNode, TextBundle, and Ulysses, I can now create mind maps that contain images and notes, outline a document visually, and then copy it to Ulysses, where I can write, edit, and continue to see images referenced inline. This feels like a much better workflow than having to constantly keep my text editor next to a mind map. I’m going to test this system and evaluate how much it could be automated1 over the next few weeks, but, overall, it’s a fantastic improvement for MindNode and Ulysses users.

MindNode 4.5 is available on the App Store.


  1. My ideal scenario: I would like to export a .textbundle archive from Ulysses and let Workflow turn local image references into images uploaded somewhere on the web. However, I can’t figure out how to open .textbundle archives with Workflow, as changing their extension to .zip won’t work. ↩︎

Workflow’s New File and Ulysses Actions

In a seemingly minor 1.7.2 update released over the weekend, the Workflow team brought a few notable file-based changes to the app.

Workflow’s existing support for cloud storage services has been expanded and all file actions have been unified under a single ‘Files’ category. You can now choose files from iCloud Drive, Dropbox, or Box within the same action UI, and there are also updated actions to create folders, delete files, and get links to files. Now you don’t have to switch between different actions for iCloud Drive and Dropbox – there’s only one type of File action, and you simply pick a service.

Interestingly, this means that Workflow can now generate shareable links for iCloud Drive files too; here’s an example of a workflow to choose a file from the iCloud Drive document provider and copy its public link to the clipboard. (Under the hood, Workflow appears to be using the Mail Drop APIs for uploads. These links aren’t pretty, but they work.)

There’s also a noteworthy change for Ulysses users. Workflow now allows you to easily extract details from Ulysses sheets using their ID. After giving Workflow permission to access your Ulysses library (which, unfortunately, still has to be done using a glorified x-callback-url method), you’ll be able to chain Workflow and Ulysses to, say, get the Markdown contents of a document, extract its notes, or copy its title to the clipboard. The new ‘Get Ulysses Sheet-Get Details of Ulysses Sheet’ combo makes Ulysses automation much easier and faster.

If you work with files in Workflow on a daily basis, and especially if you’re an iCloud Drive user, you’ll want to check out the new actions and rethink some of your existing workflows. You can get the latest version of Workflow here.


Editorial Updated with 12.9-inch iPad Pro Support, Split View Multitasking

Ole Zorn’s Editorial was the text editor that completely reimagined how I could work from iOS. While I have since moved to Ulysses as my primary text editor, I still use Editorial almost daily for its unique Markdown automation. Editorial’s combination of Python scripting and visual workflows for plain text editing is unparalleled and there’s nothing else like it on the App Store.

After a couple of years without updates and a long TestFlight beta period, Editorial has been updated for iOS Split View and the 12.9-inch iPad Pro. There are other changes (the workflow editor has been moved to the accessory panel and the Python editor now opens in a separate tab), but, overall, it’s still the same Editorial you know and love, updated for the latest iOS devices. I’ve been using the beta version of Editorial 1.3 for several months now – being able to keep Editorial next to another app is great for editing and research, and moving back and forth between a document and a workflow is easier.

As for everything else, my coverage of Editorial 1.0, 1.1, and 1.2 still stands; Editorial is the text editor for iOS power users thanks to its excellent automation features, advanced Markdown editing, and TaskPaper integration. As I wrote in November, I still edit all my longform stories in Editorial. Despite the paucity of updates, I love the app as it’s a shining example of pro software for iOS.

If you haven’t played with Editorial in a while, now’s a good time to check it out again (the app is also available at a discounted price of $4.99).