Skip to main content

Main navigation

Start for freeLog in
Moving your dataImportApple NotesMigration

Import from Apple Notes

Apple Notes has limited export of its own, so generate a .zip with an external tool (Notes Exporter, Exporter, and similar) first, then upload it.

about 5 min Updated October 13, 2026

Export from Apple Notes

1

Install an external tool

Install 'Notes Exporter' (Konstantin Bender) or a similar migration tool from the App Store or GitHub. The official macOS Notes app does not support bulk export.

NOTEThese tools read the macOS Notes database and convert it to HTML or Markdown.
2

Pick the folders to export

Export everything or only specific folders. Notes Exporter reproduces the folder structure as a directory tree.

3

HTML or Markdown format + ZIP output

Tabple recognizes .html and .md files inside a .zip, plus images (.png, .jpg) in the same folder. Save the result as a ZIP archive.

TIPKeeping images in the same folder as the note is the surest way. If a path does not match, Tabple looks for an image with the same file name elsewhere in the ZIP.

Import into Tabple

1

Go to /settings/import → pick a project

Press 'Choose file' on the Apple Notes card, or drag the file onto it.

2

Upload + automatic parsing

The folder tree inside the ZIP is converted into the Wiki page tree. Each folder becomes a parent page, and each .html or .md file becomes a child page.

CAUTIONThe Wiki tree allows at most 4 levels — notes in deeper folders are skipped. They are reported as 'N skipped' in the result on the card.
3

Check the result

On completion the card shows 'Done: N pages', 'N skipped / N errors', and 'N attachments uploaded'. Check in the Wiki whether the attached images were linked inline.

Conversion rules

  • A folder (directory) → a parent Wiki page (empty body)
  • Each .html or .md file → a child Wiki page
  • Images in the same folder → matched automatically against the path referenced by <img src> in the body or by markdown ![]() → uploaded to R2
  • The file name (without the extension) → the page title. The first heading in the body (an <h1>, or a first # line) is not moved into the title — it stays in the body
  • The original created and modified times are not imported — the pages get the time of the import
  • Checklists (- [ ] / - [x]) → the Wiki's task list node

Cautions

  • Drawings, sketches, and tables from Apple Notes are flattened into images by some external tools — text search may not reach them.
  • External tools cannot read locked notes, so unlock them before exporting.
  • For notes still syncing through iCloud, wait until the desktop Notes app has them fully downloaded, then export.
  • Past 10,000 notes, split the files into two ZIP archives.
  • Each file can be at most 50MB. You can start an import 3 times a minute, 15 times an hour, and 50 times a day; once you hit a limit, try again after the time shown in the message.
  • The number of Wiki pages stays within the project owner's plan limit (Free 100 · paid plans unlimited). If the notes you are importing would go past what is left, the import is rejected.