How to export Apple Notes to Markdown

Apple Notes can finally export Markdown on its own, which is good news if you want your notes in Obsidian, in a git repository or in a chat with ChatGPT. Here's how it works on a Mac and an iPhone, what to check in the file, and what to use when you want every note, not just one.

The File menu of Apple Notes on macOS 27 with Export To open, offering PDF and Markdown. Markdown is highlighted. Behind the menu, a Day hike packing list note.
File, Export To, Markdown, in Apple Notes on macOS 27.

Export a note on a Mac

macOS 27
macOS 26
  1. Open Notes and click the note you want to export.
  2. Choose File, Export as, Markdown. In macOS 27, the menu is File, Export To, then Markdown.
  3. Type a name for the file if you want another one, and pick where to save it.
  4. Click Save.
The Edit menu of Apple Notes on macOS 27 with Copy as Markdown highlighted, over a Spring garden plan note with its Seeds to order list selected.
Copy as Markdown copies only the part you select. New in macOS 27.

To copy only part of a note, macOS 27 and iOS 27 add Copy as Markdown: select the text, then choose Edit, Copy as Markdown on a Mac, or Copy as Markdown in the edit menu on iPhone. It works the other way too: paste Markdown into a note and it turns into headings and lists. That's also the quickest way to start a note from one of these Apple Notes templates. The Mac steps come from Apple's guide, Import, export, and print notes on Mac.

Export a note on iPhone

A drawn iPhone with a notes icon on its screen and an arrow to the Markdown mark.
On iPhone, Share, then Export as Markdown.
  1. Open the note in Notes.
  2. Tap the Share button, then tap Export as Markdown. If you don't see it, tap the View More button first.
  3. Choose where the file goes: Save to Files, AirDrop, Mail or another app.

Apple describes this in Export or print notes on iPhone.

What survives the export

Apple doesn't list what comes across, so it was tested on macOS 27 with one note that has everything: a checklist, a table with a two-line cell, a tag, a link to another note and a picture.

The test note in Apple Notes on macOS 27: a Plan for Saturday heading, a bulleted list, a checklist with Book the ferry ticked and Pack snacks open, the tag #weekend, a table with Item, Who and Cost where one cell reads Leo and And Sam on two lines, See also Groceries as a link to another note, and a picture.
The test note in Notes on macOS 27.
The exported Markdown in TextEdit: - [x] Book the ferry, - [ ] Pack snacks, #weekend, a pipe table whose second row is broken across two lines at Leo / And Sam, the plain text See also Groceries, and an image link to a file in an Attachments folder.
The same note as Markdown. The ticks survive; the two-line cell breaks the table, and the link to Groceries is gone.
In your noteIn the Markdown file
Title, headingsKept: #, ## and ###
Bold, listsKept: **bold**, * bullets, 1. numbered lists
ChecklistsKept, ticks included: - [x] and - [ ]
TablesA pipe table with a header row. A cell with two lines breaks the row, so fix those by hand
PicturesCopied into an Attachments folder next to the file, and linked from the text
TagsKept as plain text, like #weekend
Links to other notes and web linksDropped. Only the words are left
Locked notesUnlock the note before you export it

Two more things. Export writes a folder, not a lone file: the folder takes the name you type, and the Markdown file inside keeps the note's title. And every line ends in two spaces, which Markdown reads as a line break. Most apps don't mind.

Export every note at once

A drawn notes icon with lines fanning into a blue folder of Markdown files.
Every note at once needs an exporter on your Mac.

Apple's guides only describe exporting the note in front of you. For a folder or a whole library, the usual route is a free exporter that runs on your Mac and reads the Notes app for you:

What it doesGood to know
Apple Notes' own exportOne note to one Markdown file, on Mac and iPhonemacOS 26 or iOS 26 and later; nothing to install
Apple Notes ExporterA Mac app that exports every note, in its folders, to Markdown and other formats, with attachments beside each noteFree and open source (GPL); download from GitHub; asks for Full Disk Access
notes-exporterA command-line script that exports your notes to HTML, Markdown, PDF or Word, with imagesFree and open source (MIT); needs Python and the Terminal

Whichever you use, it's a copy. Apple Notes stays as it was, and a note you change tomorrow won't change in the file.

If you're moving somewhere, not making a backup

An export is the right tool for a backup or a one-off move into Obsidian or a repository. If what you actually want is Markdown notes that still work like Apple Notes, that's what Pinto Notes is for: it looks and works like Apple Notes on iPhone and Mac, and every note is Markdown underneath.

The Import from Apple Notes sheet in Pinto Notes on a Mac, with every note listed under its folder and ticked, and an Import button.
File, Import from Apple Notes in Pinto Notes. Apple Notes isn't changed.

On a Mac, File, Import from Apple Notes brings over the notes you pick in one go, in their folders, with tables and pictures. Be aware of what it leaves behind: other attachments and locked notes stay in Apple Notes. And once your notes are Markdown in Pinto Notes, ChatGPT or Claude can read and edit them directly, with your approval, instead of you pasting files into a chat. Connecting ChatGPT or Claude takes a couple of minutes. The templates give your AI a ready note to work in, like meeting notes.

If you want to script Apple Notes, AppleScript and Shortcuts are the available routes, with their own limits.

Questions

Can Apple Notes export to Markdown?

Yes, since macOS 26 and iOS 26. On a Mac, click the note and choose File, Export as, Markdown (in macOS 27 the menu is called Export To). On iPhone, open the note, tap the Share button and tap Export as Markdown. Older versions can't export Markdown on their own.

Can I export all my Apple Notes to Markdown at once?

Not with a documented Apple feature. Apple's guides describe exporting the note you have open. To export a folder or your whole library, use a free exporter on your Mac, such as Apple Notes Exporter or notes-exporter on GitHub.

Does the Markdown export keep images and attachments?

Pictures, yes: in my test on macOS 27 they were copied into an Attachments folder next to the Markdown file and linked from the text. Links to other notes and web links were dropped, and a table cell with two lines broke its row.

Can I export a locked note?

Unlock it first. Apple's iPhone guide says a locked note must be unlocked before you export it to Pages, and it doesn't describe a way around that for Markdown.

How do I get Markdown back into Apple Notes?

On a Mac, choose File, Import Markdown, pick one or more files and click Import. In macOS 27 you can also pick a whole folder and keep its folder structure; the new notes land in a folder called Imported Notes.

Checked against the app on .

Read next

More in Apple Notes

Bring your Apple Notes along.

Pinto Notes imports them on your Mac in one go, and leaves Apple Notes as it was.

Free. Requires macOS 26.

Dev · viewing as WindowsAndroidLinuxiPhoneMac ·