Articles
Published · August 12, 2026

How to Sync Plain-Text Notes Across iPhone, iPad, and Mac

Turning on iCloud Drive lets any plain-text or Markdown note you write on iPhone, iPad, or Mac stay in sync everywhere else automatically. This guide walks through setup on every device, what actually happens when two devices edit the same file offline, how to fix the version conflict that results, and when a git-based workflow is worth the extra manual step over automatic syncing.

Quick answer

Turn on iCloud Drive on every device, save your notes as .txt or .md files inside one folder there, and any editor that saves directly into that folder — instead of importing and exporting — keeps every note current across iPhone, iPad, and Mac. That's it. The sync mechanism is generic file sync, not a proprietary note format, which is exactly why plain text outlasts rich-text formats: the files stay portable no matter what app opens them next. Building this into a full habit rather than a one-off setup? It fits naturally into a plain-text note-taking system that separates quick capture from later organizing.

Step-by-step

Turn on iCloud Drive on each device

Sync only works if every device is signed in to the same Apple Account — that single requirement causes most "why isn't this syncing" problems, so check it first.

On iPhone or iPad: Settings > [your name] > iCloud > Drive, then turn on Sync this device.

On Mac: Apple menu > System Settings > [your name] > iCloud > Drive, then turn on Sync this Mac. While you're there, note that Desktop & Documents Folders is a separate toggle — leave it off unless you want your whole desktop synced too.

Put your notes where iCloud Drive can see them

Create one folder inside iCloud Drive for notes and keep it there, not scattered loose across Desktop or Documents. A flat structure like this is enough to start:

iCloud Drive/
  Notes/
    2026-08-journal.md
    project-carets-launch.md
    reading-list.txt

Use an editor that writes directly into that folder. On iOS that means an app supporting "Open in Place" rather than one that copies files into its own private sandbox; on Mac it just means saving there like any other folder. A fast plain-text inbox on iPhone is worth setting up if most of your notes start life as a quick capture rather than a deliberate sit-down write.

Confirm it's actually syncing

Open the Files app on iOS or the iCloud Drive item in Finder's sidebar on Mac and check for the sync status icon next to your Notes folder — a cloud icon means it hasn't downloaded locally yet, a checkmark means it's current. Edit a test file on one device, wait a few seconds, then check that the change shows up on another. Nothing after a minute or two on Wi-Fi? Go back and re-check the Apple Account and Drive toggle on both devices.

Common problems and fixes

My notes didn't update on the other device

This is almost always the same-Apple-Account requirement, or a Drive sync toggle that got missed on one device. Re-check both before assuming anything is broken — real sync failures are rare.

I have two versions of the same note now

This happens when the same file gets edited offline on two devices before either one reconnects. iCloud Drive can't auto-merge plain text the way a database merges structured data, so instead of guessing, it keeps both copies — appending a number to the second one — and leaves the merge to you. Two ways to cut how often this happens: settle on one "primary editing device" for any note you expect to touch offline, or split long-running notes into smaller files so a conflict only touches a few lines instead of an entire document.

I want version history, not just the latest copy

iCloud Drive only keeps you current. There's no built-in diff or revert history for an arbitrary text file the way there is for a document format with its own version store. If that matters to you, version-controlling your notes with git is the direct answer: every change gets a commit, you can diff any two points in time, and a remote like GitHub gives you the same cross-device access iCloud Drive does. The trade-off is real, though — git's whole model is built around deliberate commit-and-push, not automatic background sync, so you're trading convenience for an audit trail.

Doing this with Carets

Carets is a fast, native notes and code editor for iPhone, iPad, and Mac — Markdown, plain text, and code with syntax highlighting, organized into files, projects, and tags. It fits this workflow directly: your notes stay plain text, so they're portable and future-proof no matter where they're synced, and Carets runs native and fast on iOS and Mac rather than as a web wrapper waiting on a network round-trip every time you open a file. Once the Notes folder from this guide grows past a handful of files, files, projects, and tags give it actual structure instead of one long list you have to scroll through. Carets doesn't replace iCloud Drive as the sync layer — it's the editor that reads and writes the files iCloud Drive is already keeping current. Get Carets on the App Store for iPhone, iPad, and Mac.

Frequently Asked Questions

Do I need iCloud+ storage to sync plain-text notes across devices?

No. iCloud Drive sync for a small folder of .txt or .md files uses your existing free 5GB iCloud tier in almost every case — paid iCloud+ tiers matter for large media libraries and full Desktop/Documents sync, not a lightweight notes folder.

Will my plain-text notes sync if I'm not connected to Wi-Fi?

iCloud Drive syncs over cellular data too, but changes only save once the device reconnects — if you edit the same file offline on two devices before either reconnects, you'll get a version conflict to resolve manually rather than a silent merge.

Can I sync plain-text notes without using iCloud at all?

Yes — a git repository synced through a remote like GitHub gives you the same cross-device access plus full version history and diffs, at the cost of manually committing and pushing instead of getting sync automatically.

Why did iCloud Drive create a second copy of my note file?

That happens when the same file is edited offline on two devices before either reconnects to iCloud. iCloud Drive can't auto-merge plain text, so it keeps both versions — appending a number to the second one — and leaves the merge to you.