How to back up Markdown notes on a Mac, and check that it works

Sync is not a backup. How to back up a folder of Markdown notes on a Mac, keep iCloud files downloaded, and prove the backup restores.

Updated by Thomas Sivilay.

Sync and backup solve different problems

Sync keeps the same files on every device. That is what makes it useful, and it is also why it is not a backup. Delete a note on your Mac and sync deletes it on your iPhone too. Obsidian’s help says it plainly: services like iCloud, OneDrive, and Dropbox help you sync notes across devices, but they are not designed for backups.

A backup is a separate, one-way copy you can go back to. You want both. Sync so the notes are everywhere, and a backup so a mistake is never final.

Plain files make this simple. Raven keeps every note as a Markdown file in a folder you control, and sync sits on top of that folder rather than underneath it. Backing up your notes means backing up a folder. No export, no special format.

Find the vault folder

In Raven on a Mac, choose Show in Finder from a note or folder menu. Finder opens at that item, and you can go up to the vault folder from there.

Where it lives depends on how you set Raven up. It can be on the device, in a folder you chose on Mac, or in iCloud Drive, where the same Markdown files show up in Files and Finder on every device. Whichever it is, that folder is the thing to back up. Raven keeps attachments in a managed folder inside the vault, so images come along with the notes.

Keep the files downloaded

With Optimise Mac Storage turned on, macOS can keep older iCloud Drive files only in iCloud when space runs low. Keep the vault downloaded, and let downloads finish before you copy or back it up.

To keep the vault on the Mac, open iCloud Drive in Finder, Control-click the vault folder, and choose Keep Downloaded. An icon appears next to its name. If Raven is still downloading notes from iCloud Drive, it says how many and offers a Download button.

Turn on a separate backup

Time Machine is built into macOS. Connect an external disk, open Time Machine settings, and add it as a backup disk. Once it is on, Time Machine makes hourly, daily, and weekly backups of your files. Apple recommends a location other than your internal disk, such as an external disk or a disk on your network.

A second, simple habit helps too. Now and then, copy the whole vault folder to another drive, or compress it into a dated zip. Because the notes are plain files, that copy opens anywhere, in Finder, a terminal, git, or another editor, with or without Raven.

Test a restore with a throwaway note

A backup you have never restored from is a hope. Test it once, safely:

  1. Make a new note called Restore test with a line of text.
  2. Wait for a Time Machine backup to finish.
  3. Delete the note.
  4. Open the vault folder in Finder, then open Time Machine and go back to a backup from before the deletion.
  5. Select Restore test and click Restore.

Time Machine returns restored items to their original location, so the note goes back into the vault. Open it in Raven. If it is there with its text, your backup works. Delete the test note when you are done.

After a real restore

If you ever restore a larger part of the vault, open a few notes with images and links and check that they look right. Restoring the whole vault folder, rather than single notes, keeps attachments and the notes that point to them together.

If your vault is in iCloud Drive, reinstalling Raven can pick up the vault already there.

questions

Straight answers.

Isn't iCloud Drive already a backup of my notes?

No. Sync keeps the same files on each device, so a deleted or damaged note is deleted or damaged everywhere. A backup is a separate copy you can go back to.

What should a backup of Raven notes include?

The whole vault folder. Raven stores notes as plain .md files and keeps attachments in a managed folder inside the vault, so copying the vault folder copies both.

How do I know my backup works?

Restore something from it. Make a test note, let a backup run, delete the note, and restore it. If it comes back and opens, the backup works.

keep reading

Beautiful notes. Never locked in.

Native on Mac, iPhone, and iPad, saved as plain Markdown files you control.

Download Raven