This Week's Sponsor:

Winterfest 2024

The Festival of Artisanal Software


Posts tagged with "markdown"

Drafts for Mac: The MacStories Review


The quest for the perfect text application – for some of us it has been a lifelong goal, or at least it feels like it. I realised very early on in my computing life that I did not enjoy playing with formatting in Word or Pages, and when I discovered that Markdown provides the ability to make items **bold** or _italic_ with just a few simple characters, I felt like I had finally found my text formatting holy grail.

Many years ago I discovered Drafts for iOS, and the idea appealed: you open the application and type. No creating a new file, or trying to decide what to do with the text before the thought is fully formed, just open, type, then decide. I frequently need to jot down notes, save links, and have found being able to write without thinking too much about where the words need to go, and how they’re going to get there, is extremely helpful in today’s world of constant interruptions.

Last year saw Drafts 5 released for iOS with even more capability than before, allowing you to truly customise it to be the text editor you’ve always dreamed of having. There was only one small but important snag – no Mac version.

Today there is a Mac app. It is what many of us have been waiting for, albeit with a few missing features at the moment. Drafts for Mac has landed.

Let’s get one thing out of the way: you’ve probably heard of Marzipan, the Apple project to enable iOS developers to bring their applications to the Mac. This is not one of those apps. It is an app written from the ground up for macOS, which works as expected with the system features.

Read more


Ulysses 15 Review: Split View on the Mac, Remote Images, Improved iPad Multitasking, and More

When a productivity app feels like it’s reached maturity, it’s in a dangerous position: if active development is neglected, the app will start to stagnate amidst a changing world, but on the other hand, if change is pursued for its own sake, the app can easily become bloated and an inferior product overall.

Ulysses 15 for Mac and iOS deftly navigates those potential dangers by offering thoughtful enhancements to existing features, plus new features that truly serve to enhance the core task of writing. There are improvements to image previews, writing goals, export previews, and keywords, plus big upgrades to how the editor can be set up on both the Mac and iPad.

The core app remains largely the same, but it’s now more compelling than ever before.

Read more


iA Writer 5.2: Better Typography and External Library Locations

As I wrote in my roundup of must-have iOS apps, I’ve been using iA Writer as my text editor, primarily because of its integration with Working Copy, beautiful typography, and syntax highlighting mode. As a non-native English speaker, I find the latter particularly useful when editing articles. iA Writer was updated to version 5.2 last week, and I’d like to point out a few welcome enhancements in this release.

Read more


Drafts 5.5, MultiMarkdown, and CriticMarkup

Tim Nahumck, writing about the latest Drafts update for iOS:

One thing that is included with MultiMarkdown as an option is Critic Markup. Looking through the guide, there are several helpful elements that can be used for editing my writing utilizing Critic Markup. I can highlight some substitutions, additions, and deletions. I can highlight text to show something I might want to work on later. I can also add a basic comment somewhere that won’t be shown in a preview. And with this action, I can easily add any of them with a tap and a text entry, which inserts it in the proper format. This is helpful for creating and previewing the documents in Drafts, and gives users the flexibility to mark up files and save them back to a cloud service. I can see myself using this a lot for longer posts or large reviews. I’ve even modified my own site preview action to render the MultiMarkdown via scripting, as well as updating both my standard and linked post WordPress publishing actions to do the same.

I’ve always been a fan of CriticMarkup but have never been able to get into it as it wasn’t integrated with the text editors I used on iOS. Considering how Drafts is my favorite option when it comes to writing and editing certain annual long-form stories, and given how I came up with my own syntax in previous years to embed comments in Markdown documents, I’m going to give this a try.

Permalink

My Markdown Writing and Collaboration Workflow, Powered by Working Copy 3.6, iCloud Drive, and GitHub

For the past couple of years, I (and the rest of the MacStories team) have used Working Copy to store and collaborate on Markdown drafts for our articles. As I explained in a story from late 2016, even though Working Copy is a Git client primarily designed for programmers, it is possible to leverage the app’s capabilities to perform version control for plain text too. Each MacStories team member has a private GitHub repository where we store Markdown files of our articles; in the same repository, other writers can make edits to drafts and commit them to GitHub; this way, the author can then pull back the edited file and use Working Copy’s built-in diff tool to see what’s changed from the last version of the file and read comments left by whoever edited the draft.1

As I mentioned two years ago, this system takes a while to get used to: GitHub has a bit of overhead in terms of understanding the correct terminology for different aspects of its file management workflow, but Working Copy makes it easier by abstracting much of the complexity involved with committing files, pushing them, and comparing them. This system has never failed us in over two years, and it has saved us dozens of hours we would have otherwise spent exchanging revised versions of our drafts and finding changes in them. With Working Copy, we can use the text editors we each prefer and, as long as we overwrite the original copies of our drafts and keep track of commits, the app will take care of merging everything and displaying differences between versions. From a collaboration standpoint, using Working Copy and GitHub for file storage and version control has been one of the best decisions I made in recent years.

Read more


Choosing Your Markdown Editor: A Comparison of Ulysses and Drafts

One thing the MacStories team loves to do is constantly try new apps, compare the serious contenders in each app category, and settle on the app that suits us best. Most of the time this app evaluation process takes place on a merely private level, for personal purposes, but today I wanted to share in public an in-depth comparison and analysis of two excellent writing apps: Drafts and Ulysses.

These two apps have been on my mind a lot in recent months. To share some context, I have used Ulysses as my primary Markdown editor almost exclusively since early 2016. During that time I’ve been very happy with the app, even through its transition last year to a subscription model. I’ve continued trying out the latest updates from Ulysses’ competitors, of course, but nothing else has stuck for me. However, there’s one app I’ve long wanted to give a serious look at, but hadn’t been able to until recently: Drafts 5.

Tim Nahumck’s review of Drafts was the first tug on my interest, causing me to follow updates to the app with a close eye. Then Federico had a successful experience writing his iOS 12 review in Drafts 5. Ultimately, I couldn’t resist giving the app a serious shot any longer.

Drafts and Ulysses are very different apps in many ways. However, they share in common being powerful Markdown editors. In this article I’ll walk through their similarities, divergences, and ultimately share which app I’ve decided to write in going forward. The goal is not to say which app is better, as the answer to that question is entirely subjective. Instead, I want to help you decide which app is likely best for you.

Read more


Drafts 5.2

Tim Nahumck:

When writing my review, I needed a way to navigate between the different sections, and all of the subheadings I had created. I had developed an action to navigate to each of the markdown headers, which I was happy with at the time. It was nice to have that functionality to switch around where I was in my review.

Well, I’m happy to say that I have been Sherlocked.

In the upper right corner of the editor, there is a small triangle icon; when you tap the icon, you are presented with a navigation menu. Not only does this navigate headers in Markdown, but it also navigates projects in TaskPaper, and code blocks in JavaScript. It also include a top and bottom button, as well as a select all button.

Drafts 5.2 came out while I was in San Jose for WWDC, and I’ve been meaning to check out the new features since I started getting back into a normal routine. Tim Nahumck, of course, has a great overview of the changes in this version of Drafts, along with some useful examples you can download.

As Tim points out, the ability to navigate headers of a Markdown document through a dedicated “section popup” is a terrific addition to Drafts. Few text editors designed for people who write in Markdown get this right; one of the reasons I still keep Editorial on my iOS devices is because it lets me navigate longer pieces with a header navigation tool. However, the implementation in Drafts 5 is more powerful, modern, and can be controlled with the keyboard (you can invoke the switcher with ⌘\ and, just like Things, dismiss it with ⌘. without ever leaving the keyboard).

Speaking of Editorial, every update to Drafts 5 is pushing me toward converting all my old Markdown workflows to Drafts actions powered by JavaScript. Automation in Drafts involves a lot more scripting than Editorial’s visual actions, but I feel like Drafts 5 is a safer bet for the future. I’ve been putting this off for a long time; maybe I should spend a few days finalizing the process before I start working on a certain annual review.

Permalink