Apple Notes
Export Apple Notes as Markdown and move them into Octarine
Apple Notes can export notes as Markdown on supported versions of Notes. Export the notes you want to move, collect the generated Markdown files in a folder, then use that folder as an Octarine workspace.
Export from Apple Notes
On Mac, open Notes and select the note you want to move. Choose File > Export as > Markdown, pick a destination folder, and save the file.
Repeat this for the notes you want to migrate. If you are moving a large library, export one folder or group of notes at a time so the exported files stay easy to organize.
If you only see File > Export as > PDF, update macOS and Notes first. PDF exports are useful as read-only archives, but they are not a good editable format for Octarine.
Create an Octarine Workspace
Create a folder for the migrated notes, then move the exported Markdown files into it. If you exported notes in batches, create matching folders before moving the files so your Apple Notes organization carries over.
Open Octarine and click the Workspace Switcher in the top-left corner. Select Create Workspace, give it a name, and toggle Use an existing folder?. Choose the folder that contains your exported Apple Notes files and press Create.
Attachments
Apple Notes can include images, scans, PDFs, links, and other attachments. After export, check whether Notes created linked files next to the Markdown file or embedded references inside the Markdown.
Move exported images and files into a .attachments folder at the root of your Octarine workspace. Then update any Markdown links that still point to the old export location.
For images, standard Markdown image links will work when the paths are correct:
For file attachments, you can also use Octarine wikilinks:
[[receipt.pdf]]
[[meeting-scan.png]]
Folders and Links
Apple Notes folders do not automatically become Octarine folders unless your export preserves that structure. If your exported files are flat, create folders in your Octarine workspace and move related notes into them.
After moving notes into folders, check links between notes. Octarine supports [[wikilink]] syntax, but links should include the path from the workspace root when the target note lives inside a folder.
Compatibility Notes
Headings, lists, checklists, links, code blocks, and basic formatting should migrate well through Markdown. Apple Notes-specific features such as shared note permissions, pinned state, locked notes, smart folders, note colors, audio recordings, transcriptions, and collaboration history do not become Octarine settings.
For important notes with scans, sketches, or rich attachments, compare the exported Markdown with the original note before deleting anything from Apple Notes.