{"id":24335,"date":"2021-08-26T12:06:55","date_gmt":"2021-08-26T19:06:55","guid":{"rendered":"https:\/\/www.podfeet.com\/blog\/?p=24335"},"modified":"2021-08-26T12:06:55","modified_gmt":"2021-08-26T19:06:55","slug":"joplin-part-2","status":"publish","type":"post","link":"https:\/\/www.podfeet.com\/blog\/2021\/08\/joplin-part-2\/","title":{"rendered":"Joplin Part 2 – a Deeper Dive"},"content":{"rendered":"

A couple weeks ago Knightwise<\/a> told us about a fantastic open source, cross-platform notebook app called Joplin<\/a>. After he told us about it, I raved about it as well.<\/p>\n

This week I asked Bart whether he thought it might be the right app to replace Evernote for him he said he was waiting for me to tell him more about it, including information on how it organizes notes. When he said that, I realized I had more work to do here. The description of Joplin was from the 30,000-foot view. We talked about how it was open source, how cool it is you can sync it through any server you want including one of your own, and how it runs on every platform including the command line. But we didn\u2019t describe<\/em> it. Let\u2019s rectify that, shall we?<\/p>\n

Interface<\/h2>\n

Joplin has two distinctly different interfaces. The desktop version (which is built on Electron) is very full-featured. The mobile version is more limited but is still quite capable. I think I mentioned last time that Joplin doesn’t take full advantage of the huge screen on the iPad Pro, which is kind of a shame. Because this is an open source project, you can make suggestions in the forum for Joplin<\/a>, which I actually did on this very subject.<\/p>\n

Desktop<\/h3>\n

On the desktop, you have a 3 or 4 column view, depending on your settings. The left column shows your notebooks, represented by little folder icons. You can add subfolders, and they\u2019re shown with a downward chevron, and the folders show the number of items in each folder.<\/p>\n

When you select a notebook, the second column will show the notes and to-do\u2019s in that notebook. The last column is where you actually write your notes. Joplin uses a version of Markdown, which allows you to create beautiful headings, italics, bold, lists, and more. It\u2019s super easy to learn. Bart tried for years to convince me that Markdown is awesome, and while I’m still annoyed by some of its limitations, I have to admit it’s pretty cool. Joplin is more than a Markdown editor though, it’s actually a rich text editor because you can mix and match Markdown with embedded images and other document formats.<\/p>\n

I don\u2019t want to do a full Markdown lesson, but for context let me give just a few examples of how Markdown formatting works. When you\u2019re writing in Markdown you use asterisks for bulleted lists, underscores on either side of a word to make it italics, and hash symbols to make headings. This makes the Markdown pretty easy to read (unlike writing in HTML), and still, the rendered version is beautiful.<\/p>\n

I said that Joplin has 3 or<\/em> 4 columns. The option of the 4th column is whether you want to view just your Markdown, just your rendered view, or whether you’d like to see both side-by-side. If you want a more focused writing experience, you can toggle off the sidebar and the notes viewer giving you just your writing area with just the Markdown or the Markdown and the rendered view.<\/p>\n

If you\u2019re not a Markdown wizard, the desktop app gives you some standard icons to format as bold and italics, add links, code, bullets, checkboxes, headings and more.<\/p>\n

\"Joplin
Joplin Markdown Plugins<\/figcaption><\/figure>\n

If you have an editor you really like, at any time you can right click on a note and open it in that favorite editor. When you close the file in the external editor (without saving), the note is updated in Joplin. I thought that was a pretty cool feature.<\/p>\n

If you like the Markdown editor built into Joplin, you\u2019re going to go bananas when you see the options available to tailor your experience. In Preferences \u2192 Markdown, you\u2019ll find a list of around 20 installed plugins to enhance the standard capabilities. I\u2019m definitely not going to go through them all here but one really weird one caught my eye.<\/p>\n

The plugin says \u201cEnable Mermaid diagrams support\u201d. Well, hang on now, I certainly want mermaids in my<\/em> notes, don\u2019t you? You know I love a good diagramming application, so I simply had to investigate.<\/p>\n

\"Mermaid
<\/figcaption><\/figure>\n

Mermaid is an open source diagramming project<\/a> where you create diagrams using a normal text editor rather than a GUI where you draw boxes and lines. Creating diagrams with a text editor sounds weird, but so did Markdown when I first heard about it. An example of the syntax for Mermaid is if you write A-->B;<\/code> you get a rectangular box with an A in it followed by a box with a B, with an arrow going between them. Take out the ><\/code> symbol and it’s a straight line with no arrow.<\/p>\n

With Mermaid, you can create flowcharts, sequence diagrams, class diagrams, Gantt charts, Pie Charts, and more. I learned just enough to be impressed and amazed that Mermaid exists, then practiced a little bit inside Joplin, and learned that this is too nerdy for even me. But I still think it\u2019s amazing.<\/p>\n

The option to enable Mermaid diagrams is controlled by the desktop app, but once you enable it, the feature is available across your mobile devices as well.<\/p>\n

Mobile<\/h3>\n

Let’s switch gears to talking about the mobile version of Joplin. Instead of seeing 3 or 4 columns at once, the interface slides in and out so you can’t see all of the columns at once. For example, if you\u2019re in a notebook, you\u2019ll see the list of notes and to-dos inside the notebook. But as soon as you select a note, it will take over the whole screen. You can only view the Markdown or the rendered view but not both side-by-side.<\/p>\n

This makes perfect sense on a phone screen, but I think with a big-girl tablet like the iPad Pro, Joplin could easily show us both panes at the same time.<\/p>\n

It’s a little weird to go back and forth between the Markdown and rendered view on mobile. If you’re in the rendered view, in the bottom right there\u2019s a red circle with a little paper and pencil inside, indicating that you can edit this note. When you tap that icon you’re in Markdown editor mode.<\/p>\n

But to get back to the rendered version there’s no corresponding icon. There\u2019s a three-dot menu in the upper right and a downward arrow icon up there too, but neither takes you back to the rendered view. In the upper left, you’ll see the name of the notebook you’re in and a back left arrow. Strangely it’s that back left arrow that gets you back to the rendered view. I say strangely because once you’re in the rendered view that same exact arrow takes you to the list of notebooks. Strange UI decision but once you know it, it’s not that bad.<\/p>\n

The mobile app doesn\u2019t display the icons for bold and italics and list items like the desktop app, so you’ll have to rely on your memory of how to format with Markdown if you rely mostly on mobile.<\/p>\n

To-Dos<\/h2>\n
\"Joplin
Joplin To-Dos<\/figcaption><\/figure>\n

I\u2019ve mentioned that Joplin lets you create to-dos. You can create these to-dos within the same notebook where you put your notes. It might work for some people, but seeing a mixture of to-dos and notes in a list of things inside a notebook looks like a hot mess to me. If I start using to-dos in Joplin, I\u2019ll make separate notebooks for the to-dos within a project.<\/p>\n

When you create a to-do, it looks pretty much like a regular note, except it has a circle you can click to show you\u2019ve completed it and it gets a strikethrough in the notes list to designate that completion. You can also add an alarm to a to-do so they work well as reminders, triggering macOS’s notifications when a to-do is due. I don\u2019t see any way to add those alarms in the mobile version though, just on the desktop.<\/p>\n

\"Joplin
Joplin To-Do Notification<\/figcaption><\/figure>\n

Within your to-do you have free-form text but it’s easy to create subtasks because Markdown can create those natively with the format - [ ] List item<\/code>. In Joplin, this creates the same little circles in the rendered view, and you can check them off in the rendered view. Near as I can tell, that’s the only interaction you can do in the rendered view. When you check them off, the Markdown gets a little x<\/code> between the square brackets.<\/p>\n

Since the to-do really is a free-form text area, you can write just like in a normal note including adding in external documents such as images. I really like having this much flexibility in a to-do.<\/p>\n

Organization<\/h2>\n
\"Tags
Tags on Desktop App<\/figcaption><\/figure>\n

Bart asked me what options Joplin has for organization. I\u2019ve already explained the folder structure, but Joplin also supports tagging. This allows you to have a single note tagged for discoverability in different contexts. While one note can only be in one notebook, it can have multiple tags. I read in the forums that people really want to be able to use Boolean searches for tags, such as photography and<\/em> trains, but it doesn’t appear that’s been implemented yet.<\/p>\n

Search works really well to find notes by their content or titles. Tag searches baffled me for a bit until I finally figured out that to search for notes with a given tag, you have to precede the tag name with tag:<\/code>.<\/p>\n

\"11
Sub-Notebooks<\/figcaption><\/figure>\n

I mentioned that you can create notebooks within notebooks so I got curious how many levels deep you can go with Joplin. You can create sub notebooks 10 levels deep, but when you try to add one more, it puts the 11th one parallel at the top level. However, I think it might be a bug in the UI, because I deleted the top-level notebook that had the 9 sub-notebooks, and the 11th one disappeared too. So I think it IS still a sub-notebook but just doesn\u2019t look like it.<\/p>\n

Notes can be sorted by their creation date, update date, or by title. You can also create a custom sort in the desktop app by dragging notes up and down. You can\u2019t create custom sorts in the mobile app but you can use a custom sort you created earlier on the desktop.<\/p>\n

\"Sort
Sort Notes on Mobile<\/figcaption><\/figure>\n

Notebooks don\u2019t have as many sort options – you get sort by title and updated date. Not sure if more options are desirable as that would be enough for me.<\/p>\n

Joplin lets you create links between notes. Select a note, right-click on the title and choose Copy Markdown Link. You can then embed that link into any other note for quick access. People in the forums describe using this technique to create their own index of notes on a topic. I think links to other notes would be really useful in a to-do item as well. I normally end up typing a lot of info into a to-do so I remember why I’m doing it, but if I could just link to a note I’d already written on the topic that would be way simpler.<\/p>\n

Syncing<\/h2>\n

Joplin notebooks and notes sync across all of your devices at a specific interval. The most often you can have it sync automatically is every 5 minutes, but you can always hit the sync button to make it go on demand. Don’t forget that an advantage of Joplin is you get to choose your sync service. I’ve been using Dropbox and I haven’t had any problems with syncing.<\/p>\n

In Joplin, you can drag in images, videos, audio files, PDFs, pretty much anything you want to attach. In the Synchronization settings, you can choose whether and how to download attachments to your notes.<\/p>\n

I set mine to Always while I’ve been testing it, but if you have a giant set of notes with lots of attachments, it might make more sense to set it to Manual so you can get them on demand when you click on an attachment. The third option is Auto, which means attachments are only downloaded when you open a note. Very cool that they\u2019ve got all of these options.<\/p>\n

Plugins<\/h2>\n

One of the great joys of open source projects is when the developer creates an API (Application Programmable Interface) so that other people can write a plugin for their app to extend the capability of the application.<\/p>\n

In Joplin Preferences on the desktop, there\u2019s a link to a GitHub repo with 30 or 40 plugins<\/a> for the Joplin. A few examples include: turning ABC text notation into sheet music, embedding a list of links specified by search inside of a note, exporting of a collection of notes to a static site generator, and one that allows you to create favorite notes.<\/p>\n

There\u2019s one that will add a powerful calculator and one that will run calculations on your tables in Markdown. If you want Joplin to be skinned to look more like a native Mac app, there\u2019s a theme plugin to do just that. It’s really worth taking a look at all of these third-party plugins to see if there’s something that would make Joplin even more useful to you.<\/p>\n

Where Are the Files Stored?<\/h2>\n

One thing people might be asking is how the notes are stored. One of the reasons I like Keep It from Reinvented Software<\/a> is that every note is just a file in the Finder. I can right-click on any one of them and choose Show in Finder and get right to it.<\/p>\n

Joplin is more like other traditional notebook apps, with everything is stored in an SQLite database. I\u2019m not a database person so that makes it a bit opaque to me, but I read in the forums about someone who accidentally deleted a notebook (and emptied the trash) but was able to retrieve it from a backup using SQLite.<\/p>\n

For my personal needs, a good export method is probably just as good as Show in Finder.<\/p>\n

Exporting from Joplin<\/h2>\n
\"Export
Export Options<\/figcaption><\/figure>\n

Luckily, Joplin has quite a few options on the export front. You can export notes to:<\/p>\n