This Week's Sponsor:

Winterfest 2024

The Festival of Artisanal Software


Posts tagged with "Obsidian"

AppStories, Episode 380 – Obsidian Setup Check-In

This week on AppStories, we revisit our Obsidian systems, themes, and favorite plugins.


Sponsored by:

  • Genius Scan – A scanner in your pocket.
  • Jam: Developer-friendly bug reports in 1 click.

An Obsidian Check-In


On AppStories+, Federico ponders what notes are, what they should be, and whether he should document more of what he learns on the web.

We deliver AppStories+ to subscribers with bonus content, ad-free, and at a high bitrate early every week.

To learn more about the benefits included with an AppStories+ subscription, visit our Plans page, or read the AppStories+ FAQ.

Read more


Obsidian Shortcut Launcher 1.1 Brings Support for File Properties and Backlinks

The updated Obsidian Shortcut Launcher with support for passing document backlinks to Shortcuts.

The updated Obsidian Shortcut Launcher with support for passing document backlinks to Shortcuts.

Two years ago, we released Obsidian Shortcut Launcher, a free plugin to trigger shortcuts from Obsidian with the ability to pass input text to Apple’s automation app. In case you missed it in January 2022, here’s how I described the plugin:

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.

I’ve been using Obsidian Shortcut Launcher every day for the past two years, and I couldn’t imagine a better way to integrate my favorite text editor and note-taking app with Shortcuts. I’ve built launchers to publish articles to WordPress, upload images, perform backups of my iOS reviews, and a lot more. You can read more about my examples and find a usage guide for the plugin in the original story.

Today, I’m pleased to announce that we’re releasing version 1.1 of Obsidian Shortcut Launcher with two new integrations: properties and backlinks.

Read more


Obsidian’s ‘2023 Gems of the Year’

Silver, writing on the Obsidian blog:

It has been nearly four years since the first line of code of Obsidian was written on January 31st, 2020. Today we’re thrilled to announce the winners of our fourth annual Gems of the Year awards!

This year the Obsidian community nominated 287 projects, including plugins, themes, tools, content, and templates. After our panel narrowed down the selection and the community voted on the entries, we’re now excited to announce the winners.

Solid list of plugins and themes for the best note-taking app out there, many of which I wasn’t familiar with or hadn’t tested yet. The Border theme looks stunning and I’m going to give it a try as my primary theme in the app; the Home Tab plugin does exactly what I want from a new empty tab in Obsidian (a search box + recently opened files); Omnivore, which I’m testing as my read-later app after they added better Shortcuts integration, does a fantastic job syncing highlights to Obsidian with its plugin. Go check out this list of gems if you haven’t yet.

Side note: I’m really curious to see how the Obsidian team prioritizes updates to its iPhone and iPad apps (by far, the weakest spot of the app) in 2024.

Permalink

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

David Sparks Releases Obsidian Field Guide

No app has had a bigger impact on my day-to-day work in the past couple of years than Obsidian. What makes Obsidian tricky, though, is its flexibility and depth. It can accommodate everything from a simple Markdown note-taking system to acting as a Notion-like relational database. It’s a powerful tool, but also one that takes time to learn.

Today, David Sparks released a new MacSparky Field Guide to help newcomers get their bearings with Obsidian. The video series, which I’ve sampled, covers all the basics, taking viewers on a tour of the app’s interface, core features, built-in plugins, and some of the more popular plugins created by third parties.

The Field Guide comes in Standard and Plus editions, with the Plus Edition adding bonus content via online seminars. The Standard Edition is $49 but is currently $44 for a limited time and the Plus Edition is $99, discounted for a limited time to $89. Both limited time deals are available is you use the code OBSIDIANLAUNCH at checkout.


Automation April: Thinking About Linking

Links are the currency of information overload and distraction. There’s more media available than we could ever get to in a lifetime, and more things we might want to buy, places may want to visit, and other things to explore online than can be fit into a day.

The same problem exists in our work lives. That’s especially true for the kind of work I do. Links are part of everything. Whether I’m researching, writing, or preparing to record a podcast, I’m collecting, managing, and sharing links. I could follow all those trails as they cross my path, but I’d never get anything done.

Instead of flitting from one online discovery to the next with no plan, wasting precious time, I save links for later, putting them aside until I have time for them. I’ve been doing this forever, but I’ve also never been happy with my system. So, it was inevitable that I’d begin tinkering with my setup again, both with the apps I use and the shortcuts that support them.

Read more


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: Reverse-Engineering the Matter API and My ‘Save to Matter’ Shortcut

My Save to Matter shortcut.

My Save to Matter shortcut.

Editor’s Note: Reverse-Engineering the Matter API and My ‘Save to Matter’ Shortcut 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.

For the past few months, I’ve been enjoying and keeping an eye on the development of Matter, a new read-later service that aims to combine a powerful text parser with elegant design, social discovery features, annotations, and the ability to listen to articles as audio. I’m not one to typically care about the latest VC-backed startup that promises to revolutionize reading articles with social features, but Matter struck me for a few reasons: the app’s reader mode is gorgeous; the ability to annotate articles with highlights is great; and, more importantly, it has the best, most human-sounding text-to-audio conversion engine I’ve ever tested.

Something else happened a few months ago: Matter introduced an official plugin to sync your article highlights as Markdown notes to Obsidian. Integration with PKM-style apps is a hot trend right now in the modern crop of read-later services (John covered this very topic here), so I wasn’t shocked to see that Matter joined Readwise in supporting Obsidian with a plugin. Something about it piqued my interest though:

If Matter didn’t have a public API, how could the Obsidian plugin even sync to the Matter service?

Obviously, there had to be an API involved behind the scenes, which Matter hadn’t announced yet, but which I could potentially reverse-engineer and integrate with Shortcuts. And that’s exactly what I’ve been doing for the past month.

My experiments with the still-unannounced Matter API have developed on three separate fronts, and I’m going to share the results in three different places:

  • Today on MacStories, I’m going to share a one-click shortcut called Save to Matter that lets you save any article to your Matter queue directly from the share sheet or anywhere else on iOS, iPadOS, or macOS without having to use the Matter extension;
  • Tomorrow on MacStories Weekly for Club MacStories members, I will share MatterBot, an advanced Matter shortcut that lets you take complete control over your Matter queue with support for exporting annotations as Markdown or even downloading articles as MP3 files;
  • Next week for Club MacStories+ and Premier members only, I will share MatterPod, another advanced shortcut that lets you turn your Matter queue into a Matter podcast feed hosted on your own web server.

Before we dive in, I also want to confirm that I privately reached out to the folks at Matter weeks ago about my experiments, and they were cool with me writing about my findings and sharing shortcuts I’ve built for the Matter API.

With that being said, let’s take a look at how you can get started with the Matter API and the Save to Matter shortcut.

Read more