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.
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:
- Make a new note called
Restore testwith a line of text. - Wait for a Time Machine backup to finish.
- Delete the note.
- Open the vault folder in Finder, then open Time Machine and go back to a backup from before the deletion.
- Select
Restore testand 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.