This Week's Sponsor:

Listen Later

Listen to Articles as Podcasts

Posts tagged with "plain text"

Obsidian’s Importer Plugin Lets You Move Your Apple Notes to Any Note-Taking App That Supports Markdown

As Club MacStories members know, I’ve been spending time the past few weeks decluttering my digital life and setting up systems so it’s harder for things to come undone again. One of my strategies to make life easier for ‘future me’ is to minimize the number of places I store things.

For notes and articles I write, that means Obsidian. In the past, I’ve resisted putting every text file in Obsidian because the app’s file management tools haven’t always been the best. Part of that historical weakness is undoubtedly the result of Obsidian’s emphasis on linking between documents. Fortunately, Obsidian’s folder and file management tools have come a long way. Paired with Omnisearch, a powerful third-party search plugin, I’ve overcome my hesitation and gone all in with Obsidian as an editor and text storage solution. So, when I heard that Obsidian’s open-source import tool had been updated to work with Apple Notes, I thought I’d export some of my notes to Obsidian to get a feel for how well it works.

The Importer plugin.

The Importer plugin.

Apple Notes doesn’t have an export option. Instead, as Obsidian’s blog post on the Importer plugin update explains, it stores your notes in a local SQLite database. The format isn’t documented, but the developers of the plugin were able to reverse-engineer it to allow users to move notes and their attachments out of Notes and into two folders: one with Markdown versions of your notes and the other with the files attached to your notes. The folder with your notes includes subfolders that match any folders you set up in Notes, too.

Importer is an Obsidian plugin that can be downloaded and installed from the Community Plugins section of Obsidian’s settings. The Importer’s UI can be opened using the command ‘Importer: Open Importer,’ which gives you options of where to save your imported notes, along with options to include recently deleted notes and omit the first line of a note, which Obsidian will use to name the note instead. Click the Import button, and the plugin does its thing. That’s all there is to it.

When you run Importer, it requires you to confirm where your Notes are stored, which is easy because the plugin takes you there itself.

When you run Importer, it requires you to confirm where your Notes are stored, which is easy because the plugin takes you there itself.

I ran Importer twice to see how well it worked in practice. The first time was on a set of more than 400 notes, many of which hadn’t been touched in years. The import process was fast, but it failed on 36 notes, and it wasn’t clear from the plugin’s interface whether that caused it to get stuck part of the way through or if the plugin just skipped those notes. I don’t know why some of my notes failed to import, but the results weren’t too bad for an undocumented file format of an app with no official export feature.

Importer isn't perfect but it's close enough given my large collection of old, rarely touched notes.

Importer isn’t perfect but it’s close enough given my large collection of old, rarely touched notes.

The import process is non-destructive, meaning it doesn’t delete the notes in Apple Notes. I took advantage of this by deleting everything I’d just imported into Obsidian. Then, I went back to Notes and cleaned them up a bit, deleting old notes I didn’t need anymore and reducing the total note count to 149. I re-ran Importer, and this time, I got no errors. I haven’t checked every note, but based on a spot check, the import process looks like it was successful.

The end result of using Importer is a folder of Apple Notes and related subfolders, plus a folder of attachments.

The end result of using Importer is a folder of Apple Notes and related subfolders, plus a folder of attachments.

One limitation of Obsidian’s Importer plugin is that it requires you to use the Obsidian app. However, the beauty of plain text is that once you have a folder full of Markdown files, you can use them with any app that supports Markdown, so it’s a tool worth considering whether you’re an Obsidian true believer or not.

That said, I don’t intend to abandon Apple Notes completely. It was easy to move a bunch of reference notes to Obsidian, where they’ll be easier to use alongside other notes. However, Obsidian’s Achilles heel is its lack of a workable system for collaboration. Until there’s a fast, secure, and simple way to share and edit notes with others, I’ll still use Apple Notes’ sharing feature. For everything else, I’m in deep with Obsidian because the portability and flexibility of plain text combined with a rich selection of third-party plugins make it the best tool for the sort of work I do.

Obsidian’s Popularity Explained→

It’s been nearly three years since I first started using Obsidian. The app has come a long way since then. The app’s core functionality has expanded, its vibrant plug-in developer community continues to go strong, and more and more users have been captivated by its flexibility. According to Jared Newman, writing for Fast Company,

Obsidian estimates that it has one million users, and its Discord channel has more than 110,000 members, who use the app for everything from task management and bookmarking to organizing their daily thoughts.

That’s remarkable growth for an app originally developed by just two people and with a team that still stands at under a dozen members.

Newman’s story, The cult of Obsidian: Why people are obsessed with the note-taking app, does an excellent job capturing what makes Obsidian special and even attracts fans of native apps like Federico and me:

John Voorhees, the managing editor at MacStories, started using Obsidian a couple of years ago after being drawn to its local file structure, and both he and MacStories founder Federico Viticci have written extensively about their Obsidian setups since then.

Obsidian is on [sic] some ways the opposite of a quintessential MacStories app—the site often spotlights apps that are tailored exclusively for Apple platforms, whereas Obsidian is built on a web-based technology called Electron—but Voorhees says it’s his favorite writing tool regardless. He and Viticci have even commissioned some bespoke plug-ins for their Macstories [sic] workflows.

“No matter what your writing needs are, there’s probably a plug-in to satisfy them,” he says.

There are a lot of other reasons I use Obsidian, including its use of local, plain text files formatted in Markdown, but it’s the plug-in system that has made it indispensable to my work. The app simultaneously serves as my text editor, note-taking app, and database all at once, allowing me to move effortlessly among projects and tasks, thanks to the portability of plain text.

Permalink

Automation April: Processing Tot Dots with Shortcuts

I’ve used Tot by The Iconfactory on and off since it was released in 2020 and reviewed by Federico, but it never stuck. I never came up with a system for using the app that fits well with how I work. Instead, I would simply dump text and URLs copied from the web or jot notes to myself haphazardly in any of the app’s seven colorful dots. The trouble was that when I went back to the app to find something, I often found myself clicking and scrolling around a lot to find what I wanted.

With the introduction of Tot’s Shortcuts support, I immediately saw an opportunity to process Tot’s dots in ways that would make the app fit better with the way I use it. I still don’t have a system for the app’s seven dots. Instead, I’ve got a shortcut called Tot Dot Review that lets me parse and process Tot’s dots in several different ways that shows off Tot’s shortcuts actions along with a handful of built-in Shortcuts actions for extracting different types of data from text.

Tot Dot Review lets me quickly pull URLs, Apple Maps URLs, addresses, phone numbers, and dates from my Tot notes without skimming through each of the app’s seven notes. I can also copy Tot’s notes into Markdown-formatted text that I can copy and paste into another app for processing and delete the content of all seven Tot notes, so I can start fresh. The combination of options has made it easier to find and manage things in Tot, which has led me to use the app more too.

Read more

My Obsidian Setup, Part 1: Sync, Core Plugins, Workspaces, and Other Settings

My Dashboard workspace in Obsidian for iPad.

My Dashboard workspace in Obsidian for iPad.

Last month, after a long beta period I’ve participated in for the past few months, the official Obsidian app for iPhone and iPad launched on the App Store. I’ve covered Obsidian and my approach to writing my annual iOS review in it on both AppStories and Connected; because I’m busy with that massive project and an upcoming major relaunch of the Club (hint hint), I don’t have time right now to work on a proper standalone, in-depth review of Obsidian for MacStories. So, given my time constraints, I thought it’d be fun to do a multi-part series for Club members on how I’ve set up and have been using Obsidian as my Markdown text editor and note-taking app of choice.

Read more

Text Case Adds Customizable Flows: User-Created, Multi-Step Text Transformation

Text Case is a text transformation app that includes 37 text transformations. The app can capitalize titles according to multiple style manuals, trim whitespace, URL encode and decode text, change text to all uppercase or lowercase lettering, generate Markdown, and more.

You can type or paste text into Text Case to transform it, but with the introduction of Shortcuts support in 2018, Text Case became an app that could be used exclusively as a series of Shortcuts actions too. The hasn’t changed, but now, you can also create multi-step text transformations for use in the app itself or from Shortcuts or the share sheet, adding a new level of convenience. The update marks an interesting shift of focus from a tool that applied individual transformations to text one at a time to a text workflow creation tool that uses a UI that is reminiscent of Shortcuts.

Read more

Tot’s New Share Extension→

Craig Hockenberry, writing on The Iconfactory blog:

We’re happy to announce a new version of Tot with some features frequently requested by the app’s legion of fans.

The main focus of today’s release are system extensions that allow Tot to co-exist with other apps. To this end, we’ve added a Sharing extension for both iOS and macOS. Additionally, there’s also a widget for iOS that lets you quickly access any of Tot’s dots. Like everything else in Tot, attention was paid to minimizing friction, allowing information to be collected as quickly as possible.

Tot’s new share extension is, quite possibly, the best one I’ve ever tried for a plain text note-taking app. In an intuitive, compact UI, the extension offers everything I need: I can pick one of Tot’s seven dots; I can choose to append or prepend text to a dot; the extension even lets me pick the number of line breaks I want to put between a dot’s existing content and the new text I’m inserting into a note. And here’s the best part: the upper section of the share extension’s popup has a full, scrollable preview of the selected dot, so I can see what the entire note will look like before appending or prepending text. Tot is the first note-taking app I’ve used that gets this aspect of sharing text/links to an extension right.

Tot's new share extension

Tot’s new share extension

It may be considered a small enhancement to the app, but Tot’s new extension shows how much consideration went into designing an experience that is both powerful and willing to get out of the way as quickly as possible. I wish more note-taking apps offered a share extension similar to The Iconfactory’s app, which, months after its original release, I still use as my go-to scratchpad every day.

Permalink

iA Writer 5.5→

iA Writer, my favorite text editor for all Apple platforms (which I still use as the central piece of my Markdown collaboration workflow via GitHub), has been updated today to version 5.5 both on Mac and iOS/iPadOS. I’ve been testing this version for quite some time (it’s the update I originally mentioned in my Modular Computer story back in April), and there are some fantastic details worth pointing out.

On iPad, the app can now be fully controlled with the trackpad. Besides obvious support for clicking toolbar buttons and other elements in the app’s UI, trackpad support includes the ability to swipe horizontally with two fingers to show/dismiss the Library sidebar (which I do all the time now) and – my favorite touch – support for clicking a document’s name in the title bar to rename it. I’m so used to these two new pointer features in iA Writer 5.5, I wish more iPad apps adopted them.

Version 5.5 also brings support for highlighting text inside a document by surrounding it with two equal signs – e.g. ==like this==. Highlighted text will turn yellow, and it’s impossible to miss. When I used Scrivener to write one of my iOS reviews years ago, the ability to highlight text in the editor was one of my favorite options to mark specific passages for review; with iA Writer 5.5, I can now highlight text and have a clear visual indication without giving up on the Markdown syntax. Even better: there’s a new ⌘⌥= keyboard shortcut to toggle highlighted text.

Among a variety of other updates (you can read more about them on the developers’ blog), iA Writer 5.5 also comes with a powerful PDF preview (which supports custom templates, so I can export my drafts as PDFs that look like the MacStories website) and the ability to show multiple stats in the editor at once. Thanks to the latter option, I can now see my word and open task count at once while I’m editing a story.

I’ve been using iA Writer as my only text editor for two years now, and I’m continuously impressed by the thoughtfulness and attention to modern iOS/iPadOS technologies that goes into the app. You can get iA Writer 5.5 on the App Store and read more about my writing setup based on iA Writer, Markdown, and file bookmarks here.

Permalink

Tot Review: Collect and Edit Bits of Text

Tot for iPhone, configured with SF Mono as a custom font.

Tot for iPhone, configured with SF Mono as a custom font.

Over the past few weeks, I’ve been on a quest to discover the best iPhone and iPad apps to collect and edit various bits of text I come across every day. The result of this research was a collection in Issue 211 of our Club-exclusive newsletter MacStories Weekly, in which I rounded up the six most interesting plain text apps I’d found browsing the App Store. Members can check out the full collection in the newsletter archive, but, for context, here’s how I led the story:

I often find myself wanting to store random bits of plain text in a document, which I don’t want to save in Apple Notes or iA Writer where my more important notes and documents live. I just want a quick way to stash random, disposable pieces of text – phone numbers, addresses, URLs, etc. – that I will discard shortly after. Inevitably, my research led me to discover a bunch of apps I wasn’t familiar with.

[…]

For the purpose of this roundup, I have excluded apps like iA Writer, 1Writer, Drafts, and other, more complex text editors that go beyond the simple act of just saving text in a scratchpad. While it is possible to use those apps for that kind of task – and I believe plenty of folks use Drafts like that – I was effectively looking for iPhone and iPad alternatives to Apple’s TextEdit for Mac.

I use Apple Notes for general-purpose note-taking, but I’ve started moving some of my videogame-related documents and notes that require heavier formatting to Noto (which Ryan reviewed here). All my writing happens in iA Writer, where I do not want to store any other plain text (Markdown) content that won’t end up either on MacStories or Club MacStories. Lately, however, I’ve found myself searching for a tool that lets me jot down (or otherwise collect from Safari or Mail) random bits of text that are important for the moment, but ephemeral, and as such not a good fit for the richness of editing tools available in Notes or Noto. You may be familiar with this problem: maybe it’s a phone number you need to keep handy for a couple minutes, or a list of three items you need to buy at the supermarket, or a URL to a webpage you need to share with a colleague. To me, using Apple Notes or Drafts for this kind of plain text content expiring soon feels excessive; I just want a scratchpad that frees my brain of the responsibility to hold this text with as little friction as possible.

Enter Tot, the latest release from The Iconfactory. At a high level, Tot is a plain text editor that lets you swipe across seven documents from a single view; each document is represented by a colored dot, and the color is also used for the document’s background to make it visually stand out from the other six. You can switch between plain text and rich text editing modes with the tap of a button; there are word and character counts above the keyboard; when you’re done editing, you can share your text as .txt or .rtf documents with other apps. On a superficial analysis, Tot may not seem that different from the plethora of lightweight Markdown or rich text editors available on the App Store. What sets The Iconfactory’s latest app apart, however, is the combination of embracing constraints and adopting system technologies with a thoughtful, balanced design. Allow me to explain.

Read more

iA Writer 5.4 Adds New Export Options, Local Backups, and Hashtag Suggestions

Over the holidays, the iA Writer team released version 5.4 of its iOS, iPadOS, and Mac apps, which added improved export options. The iOS and iPadOS apps also gained local backups and hashtag suggestions.

The new export feature adds the ability to share, export, print, and copy from the app’s Library using context menus. On iOS and iPadOS, each of those commands is available by long-pressing an item in your Library and picking from the popup context menu. The experience is similar on the Mac, where the same options are available when you right-click on an item in the Library. iA Writer’s release notes say that publishing is available via context menus too, but the MacStories WordPress setup doesn’t work with iA Writer, and I don’t use Ghost or Medium, so I haven’t tried that feature.

iA Writer includes a new Copy Markdown Action.

iA Writer includes a new Copy Markdown Action.

The alternatives for getting text out of iA Writer have been expanded too. The update’s Copy action has added a Copy Markdown option that makes it trivially easy to copy your work and drop it into another iOS or iPadOS app or paste it into a Mac app using Handoff.

Better yet, the Copy Markdown functionality includes content blocks to the copied text. That way, if you split a long document into multiple files, copying the Markdown of the main document will automatically incorporate the externally referenced files as content blocks. It’s an excellent way to assemble a long-form story and paste it into a content management system or another app with just a couple of taps. Together with the app’s existing copy, share, and export options, iA Writer has become one of the most versatile text editors when it comes to delivering your final text in the format you want and where you need it.

A local backup is saved as your document is edited.

A local backup is saved as your document is edited.

On iOS and iPadOS, iA Writer 5.4 has also added local backups, which are accessed from the action button in the toolbar, by swiping left on or long-pressing an item in your Library, or using Quick Search, which Federico covered in his review of version 5.3 of the app. Backups of your files are created as you edit them, and reverting to an older version is as simple as selecting the one you want and tapping ‘Restore.’ If you change the name of a document, the app keeps the older backups under the file’s original name. You can also navigate to the root level of your Library folder structure from the backups of the document you are currently viewing, allowing you to browse every local backup created by iA Writer on your device.

The strength of iA Writer’s backup feature is that the backups are local. iOS 13 has been a buggy release, and iCloud Drive continues to cause trouble for some users. By creating a local backup, iA Writer provides its users with a copy of their work on whichever device they’re using that isn’t affected by sync or other cloud-based issues.

In my testing, the new backup feature worked well and provided additional peace of mind that my work is safe, which I love. I did run into a bug when navigating back to the editor from the backup view when I entered it via the Library’s context menu. The editor lost the focus, so I had no cursor or keyboard, though it’s an issue that can be fixed by tapping into another document and then back to the one you’re editing. Hopefully, that will be fixed soon, but for now, the workaround is simple, and the issue is easily avoidable by not using the context menu to access backups for the time being.

iA Writer’s hashtag suggestions appear in the row above its custom keyboard.

iA Writer’s hashtag suggestions appear in the row above its custom keyboard.

Another iOS and iPadOS-only feature that’s new for version 5.4 is hashtag suggestions. Hashtags aren’t a feature of iA Writer that I use, but the update makes accessing hashtags more convenient by displaying the most recent three in the row above the app’s custom keyboard if your cursor is on an empty space. Alternatively, if the cursor’s inside a word, the top row offers to convert the word into a hashtag. It’s worth noting, however, that hashtag suggestions are not displayed when iA Writer’s custom keyboard is displayed as a popover on the iPad Pro.

In the broader scheme of iA Writer’s development, version 5.4 is a relatively minor update, though it does reinforce why the app was chosen as the MacStories Selects App of the Year. iA Writer has been a category-leading text editor for years, but it continues to receive regular updates that incorporate the latest technologies on every platform in ways that refine the experience for users and expand the app’s capabilities.

There’s an incredible amount of power tucked away behind iA Writer’s simple UI. That power is always just a tap or two away, but stays hidden until you need it, which is my favorite sort of pro app UI.

iA Writer 5.4 for iOS and iPadOS and for the Mac is available as a free update for existing users.