“My Markdown notes sync with iCloud” can describe several different systems. The practical differences show up when you look for the files, work offline, or move your notes to another app.
.md files in iCloud Drive
In a file-based workflow, the notes are individual Markdown files in an iCloud Drive folder. On Apple devices, iCloud Drive exposes files through Finder or the Files app, subject to the folder and app permissions you use. Another editor that can open those files may be able to work on the same collection.
The folder may also contain images and other attachments. Keep their relative paths intact when moving or backing up the collection. Check how conflicts are handled if you edit the same file on two devices before sync finishes. Apple’s iCloud Drive guide describes its file-facing model.
App-managed CloudKit data
An app may use CloudKit to sync structured note records in its own container. Those records are not automatically a visible folder of .md documents in iCloud Drive. The app decides how to represent notes and how to export them. Apple describes CloudKit as an app-data service with private databases and syncing capabilities.
First-party disclosure: Ember Notes, made by this site's publisher, uses SwiftData and CloudKit for its standard note library and offers Markdown export. That library's iCloud sync is not the same as editing .md files in iCloud Drive. Check the current Mac app for any separate local-vault features.
Manually moving Markdown files
You can also save .md files locally and copy them to iCloud Drive or another location when you choose. That gives you explicit control, but it means the copying and conflict decisions are yours. A periodic copy is not the same as continuous sync, and sync is not a substitute for a separate backup.
Questions worth asking
- Can I see and open the
.mdfiles in Finder or Files? - If the app has its own store, can I export all notes and attachments together?
- What happens after editing offline on more than one device?
- Can I restore the exported collection into a new location?
Pick the model that suits your work, then do one small end-to-end test. A sync badge tells you less than opening a note on another device and checking an export. See Markdown files for file basics and exporting Markdown for a practical exit test.