How iCloud Drive notes sync works

What iCloud Drive sync means for a notes app that stores files, what you see while a note is on its way, and what happens when two devices edit one note.

Updated by Thomas Sivilay. Compared as of .

What iCloud Drive sync means for a notes app that stores files

Saving and syncing are two separate steps. When a notes app stores files, a note saves on your device first. Then iCloud Drive moves that file to your other devices, once it has a connection and a moment to do it.

That order matters if you have ever opened a notes app on a second device and thought a note was gone. Most of the time the note is not lost. It has not arrived yet. The file exists on the device where you wrote it, and the copy on the other device is waiting for the transfer to finish.

This is also why a file-based app keeps working with no signal. You can write on a plane or in a basement. The save happens locally, and the sync catches up later.

How Raven uses it

Raven is a Markdown notes app for Mac that stores your notes locally as plain Markdown (.md) files on your device. Raven is local-first because those files sit in a folder you control. Sync sits on top of that, not underneath it. The files are the source of truth, and iCloud Drive is only the transport.

To sync, choose iCloud Drive in Settings. Raven keeps your vault as plain Markdown files you can open in Files or Finder across iPhone, iPad, and Mac. If you reinstall Raven, it can pick up the vault already there.

A few things follow from that.

  • Raven works offline without an account. There is nothing to sign up for to sync.
  • Capture and edit work fully offline. The file saves locally first.
  • If you stop using Raven, the notes are still ordinary text files in iCloud Drive.

iCloud Drive is one of three places a vault can live. You can also keep notes on this device only, or on Mac you can choose a folder. Choosing a folder works on Mac only.

When a file is still on its way

Sync takes time, and Raven shows what it knows while it happens.

While iCloud files are still transferring, Storage shows Syncing. If you open Raven on a second device right after writing on the first, check that label before you decide anything is missing.

Raven also looks for notes that iCloud Drive has not finished downloading. From the code, it says how many are still coming and offers a Download button in Settings under iCloud Drive. Notes already on the device stay as they are. I have read this behaviour in the app’s code but have not forced the situation on a real device, so treat it as what to expect rather than a promise about every case.

Two devices, one note

The harder case is two devices editing the same note before either has synced.

Raven keeps both versions when two devices change the same note, and it is built to let you choose what to keep. I have not run a two-device edit end to end myself, so that is the design and not a tested result.

There is a limit you should know about. Not every conflict can be reviewed inside Raven today. When Raven cannot open the review, the text still survives in a recovery copy, so the words are not thrown away. You may have to find that copy and merge by hand.

I can’t tell you exactly when a conflict will appear. A conflict flag is not a reliable sign that two devices clashed, and no flag is not proof that they did not.

The practical rule is simple. Avoid editing one note on two devices at the same time, and give one device a moment to finish syncing before you pick up on the other.

Good habits

None of this is specific to one app.

  • After big edits, let sync finish before you close a laptop lid or switch to another device.
  • Keep a backup copy of your notes folder somewhere other than iCloud Drive. Sync is not a backup. A change that syncs, including a deletion, syncs to every device. The backup guide shows how to set one up and test a restore.
  • When a note looks missing, wait and check again before you retype it. Retyping on the second device is how two versions are born.
  • If you move a library to a new app or a new Mac, copy it first and keep the original until you have checked the copy.

Obsidian takes the same approach. It can sync a vault between iPhone and Mac over iCloud Drive without paying for Obsidian Sync. On mobile, the vault has to sit in Obsidian’s iCloud folder.

Where this leaves you

iCloud Drive sync is a file transfer, and that is a good thing to know. A note exists on the device where you wrote it before it exists anywhere else. If you want that model with no account and notes you can open in any text editor, Raven for Mac, iPhone, and iPad works this way.

questions

Straight answers.

Does Raven need an account to sync?

No. Raven works offline without an account. To keep the same notes on iPhone, iPad, and Mac, choose iCloud Drive in Settings.

Can I still write when I have no connection?

Yes. Raven captures and edits fully offline. The file saves on your device, and iCloud Drive moves it to your other devices afterward.

What if two devices edit the same note?

Raven keeps both versions. Not every conflict can be reviewed inside Raven today, but the text survives in a recovery copy.

keep reading

Beautiful notes. Never locked in.

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

Download Raven