This Week's Sponsor:

Winterfest 2024

The Festival of Artisanal Software


Posts tagged with "markdown"

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.


Automation April: 10 Shortcuts for Mac Multitasking, Markdown, Reminders, Music Lyrics, Twitter, and More

10 shortcuts for Automation April.

10 shortcuts for Automation April.

Automation April is well underway: we’ve entered the second week of our month-long special event about automation on Apple platforms, and – in case you haven’t noticed – things are happening everywhere. We’ve published Shortcuts-focused articles on MacStories; interviewed developers of Shortcuts-compatible apps on AppStories; we’ve hosted a Town Hall Workshop on our Discord along with giveaways. And, of course, our panel of judges is now busy testing and evaluating shortcuts submitted by people for the Automation April Shortcuts Contest. If you haven’t yet, now would be a great time to start following @AutomationApril on Twitter to keep up with everything we’re doing.

Last week, I shared an initial batch of 10 shortcuts I prepared for Automation April here on MacStories. I’m back this week with another set of 10 shortcuts that encompass a variety of platforms, app integrations, and functionalities. In this week’s collection, you’ll find even more shortcuts to speed up macOS multitasking; a shortcut that makes it easy to create a calendar event starting from a date; there will be a couple of shortcuts for Markdown and Obsidian users too.

I’m having a lot of fun sharing these sets of shortcuts for Automation April. So once again, let’s dive in.

Read more


MacStories Starter Pack: Introducing Obsidian Shortcut Launcher, A Free Plugin to Trigger Shortcuts from Obsidian

Obsidian Shortcut Launcher is a free plugin that works on iOS, iPadOS, and macOS.

Obsidian Shortcut Launcher is a free plugin that works on iOS, iPadOS, and macOS.

Editor’s Note: Obsidian Shortcut Launcher is part of the MacStories Starter Pack, a collection of ready-to-use shortcuts, apps, workflows, and more that we’ve created to help you get the most out of your Mac, iPhone, and iPad.

It shouldn’t come as a surprise to anyone that, over the past year, Obsidian has become as essential to my workflow as Shortcuts. As I have been thoroughly documenting in the My Obsidian Setup series for Club MacStories members, Obsidian – which is the MacStories Selects 2021 App of the Year – is more than a text editor: it’s something more similar to an OS for writers that encompasses note-taking, Markdown writing, journaling, research, and more. At this point, just like I can’t imagine using Apple devices without Shortcuts, I can’t imagine taking notes or writing articles without Obsidian.

Which means that it shouldn’t surprise anyone either that I wanted to combine my two favorite apps and figure out a way to integrate Obsidian with Shortcuts.

Today, I’m thrilled to introduce Obsidian Shortcut Launcher, a free Obsidian plugin – available in the Community Plugins section of the app – that lets you trigger shortcuts as commands from Obsidian. With Obsidian Shortcut Launcher (or ‘OSL’), you’ll be able to trigger any shortcut you want from Obsidian, passing along values such as the text of the document you’re working on, its name, text selection, and more. Obsidian Shortcut Launcher is free to use and works on iOS, iPadOS, and macOS.

Obsidian Shortcut Launcher is the result of weeks of planning and work from me and Finn Voorhees, and it has created an entirely new dimension in how I use Obsidian and Shortcuts on a daily basis. Because OSL is available in Obsidian’s Community Plugins list, you can find its source code here. Read on below to find out how OSL works behind the scenes, how I’ve been using it for my setup, and how you can start using it yourself with Obsidian and your favorite shortcuts.

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


Ulysses 21 Brings Revision Mode to iPhone and iPad Alongside Updated Design

Today the latest version of Ulysses, the excellent Markdown text editor, was released for iPad and iPhone. Ulysses 21 comes with two main changes: it brings the previously Mac-exclusive revision mode to iOS and iPadOS, while also introducing design updates that take advantage of new iOS 14 design elements, such as pull-down menus. It’s not a huge update, but it’s a nice one nonetheless for iPhone and iPad users.

Read more


Ulysses 20 Review: New Dashboard Featuring Advanced Grammar and Style Check, Outline, and Much More

Ulysses 20 for iPad’s new dashboard.

Ulysses 20 for iPad’s new dashboard.

One of the promises regularly made by apps transitioning to a subscription model is that they’ll be able to deliver more regular, incremental updates rather than going untouched for extended periods of time, and they can also focus on adding functionality that existing users will appreciate rather than needing to build something entirely different to attract a new target market. Ulysses has been a subscription app for nearly three years already, and I believe it’s one of the apps doing the best job of delivering on both of those fronts.

A quick search on MacStories will show that I’ve covered Ulysses a lot, in part because it’s my primary Markdown editor, but also because there are consistently several updates per year that stand out as noteworthy and meriting a fresh review. Today’s version 20 is no exception, introducing an advanced grammar and style check ‘revision mode’ on the Mac (coming soon to iPad and iPhone) and a new dashboard view across all platforms. Both enhancements leave what was already great about Ulysses alone, while offering valuable new utility for writers sure to delight existing users and perhaps even draw a flock of new ones.

Read more


Drafts 20 Introduces Advanced Wiki-Style Linking

Drafts 20, the latest update to the powerful text editor and capture tool, introduces an excellent feature for creating in-line links to other drafts, workspaces, or even searches.

I’ve always appreciated the ability to link notes inside of other notes, like what’s available in Bear, and that’s exactly the behavior that Drafts 20 enables. By typing an existing draft’s title inside of double brackets (e.g. [[Draft Title Here]]), you can create a Wiki-style link to that draft that can be tapped or clicked for instant access. For research purpose especially, I’ve found this functionality useful in the past, and I’m glad to see it in Drafts.

One nice detail of Drafts’ implementation is that you can use the same syntax to create links to brand new drafts; if you type a title in brackets that doesn’t currently exist, the app will automatically create a new draft with that title. The system is smart enough, too, to work with only partial titles entered. For example, with an old draft titled “Apple Card Now Available for All US Customers,” all I had to type in brackets was ‘Apple Card’ for the link to be created. The only enhancement I hope to see in a future update is auto-complete suggestions when typing a draft’s title so you can ensure you’ve entered the correct one.

Linking to other drafts is certainly the primary appeal of the new bracketing syntax, but developer Greg Pierce has included a handful of advanced options too that make the feature even more valuable. As detailed in the update’s release notes, you can bracket not just other draft titles, but also links to your existing workspaces, a search term inside the app, or even a Bear note. My favorite options, however, enable creating one-tap links to Google or Wikipedia searches. By typing google: or wikipedia: then a search term, all inside double brackets, Drafts will create links to initiate those types of searches. The added flexibility afforded by these links, alongside the new links to other drafts, makes Drafts a strong research and database tool, alongside all the other things the app’s great at.

Drafts 20 is available on the App Store.


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

Ulysses 19 Brings iPad Cursor Support, External Folders, Material Sheets, and More

The latest version of Ulysses, the excellent Markdown editor, is available now. Ulysses 19 offers enhancements in several different areas, from fully optimizing for the new iPadOS cursor, to supporting external folders for the first time, introducing a new ‘material’ designation for sheets, and adding keyword improvements, exportable backups, and even a new font. It’s a strong update, and one that continues to prove Ulysses the best app for my writing needs.

Read more