Sync with iCloud

No account to create, no plugin to install. Put the folder in iCloud, open it in SoloMD, done.

Why there is nothing to configure

Your notes are ordinary .md files on disk — no private database, no proprietary format. So syncing doesn't involve SoloMD at all: iCloud is already syncing that folder, and SoloMD just reads and writes local files.

Which also means the same approach works for Dropbox, OneDrive, Google Drive and Syncthing — substitute that provider's folder below.

On a Mac

1. Open Finder and click iCloud Drive in the sidebar
2. Create a folder in it, e.g. Notes
3. SoloMD → Open Folder → pick that Notes folder

That's the whole setup. From then on every save propagates to your other devices in the background.

On disk that folder really lives at ~/Library/Mobile Documents/com~apple~CloudDocs/ — Finder's "iCloud Drive" sidebar entry points there. Handy to know if you want to cd into it from a terminal.

Two things SoloMD adds on top

1. It recognises cloud folders

When you open a folder, SoloMD checks whether it sits inside iCloud, Dropbox, OneDrive or Google Drive. If it does:

• A banner tells you the vault is already being synced by that provider
• It stops nudging you to set up GitHub sync — the cloud drive is already doing that job, so the prompt would just be noise

2. Cross-device session restore

Each device writes a small file recording which tabs you have open. Open the same vault on another machine and, if a newer record from a different device is found, SoloMD offers to restore it — your tabs come back as you left them.

Those records live in .solomd/ inside the vault and sync along with everything else. They are only written inside genuinely cloud-synced folders — open a plain local folder and SoloMD leaves nothing behind.

iPhone / iPad

Same idea: SoloMD on iOS reaches iCloud Drive through the system Files app. Open the same Notes folder you created on the Mac — it is literally the same files.

Android has no iCloud (Apple ships no Android client). For cross-device sync there, use a provider that does have an Android app — Dropbox, OneDrive — or GitHub / Gitea sync.

Worth knowing

• Don't edit the same file on two devices at once. iCloud syncs at file level; it will not merge two sets of edits inside one file. If it happens you get a "conflicted copy" to reconcile by hand. Writing on machine A and reading on machine B is completely fine.
• Let it finish before closing the lid. On a slow connection iCloud may still be uploading. A cloud icon next to the filename in Finder means it is still in flight.
• iCloud gives you no version history. If you want "undo a bad edit", "see what changed", or real conflict handling, that's the other route — see Sync, History & Backup. SoloMD has local snapshots and GitHub / Gitea sync built in, and both work alongside a cloud drive.
• "Optimise Mac Storage" can evict files to the cloud. When disk space runs low macOS keeps only placeholders locally. Note vaults are usually far too small to be picked, but if opening gets slow you can turn it off in System Settings → Apple Account → iCloud.

If it isn't working

• No cloud banner? SoloMD didn't recognise the path as iCloud. The usual cause is opening an alias or symlink that points into iCloud rather than the real path. Re-open it from Finder's "iCloud Drive" entry.
• Other device doesn't see new notes? Check both are opening the same folder (not same-named local ones), that both are signed into the same Apple Account, and that iCloud Drive is enabled.
• Still stuck? Open an issue with your path and what you see, and we'll dig in.