Notion
Export Notion pages as Markdown and CSV for Octarine
Notion can export pages as Markdown & CSV. Octarine can use the Markdown files as notes, while exported CSV files are best kept as reference files or converted manually if you want them to become notes.
Export from Notion
Open the page or top-level section you want to migrate. Click the ... menu in the top-right corner and choose Export.
Choose Markdown & CSV as the export format. Turn on Include subpages if you want nested pages included as separate files, then export the ZIP file and unzip it.
To export an entire workspace, go to Settings > General > Export all workspace content on desktop or web. Notion will email you a download link when the export is ready.
Create an Octarine Workspace
After unzipping the export, open the folder and inspect the generated files. Notion usually creates Markdown files for regular pages and CSV files for databases.
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 unzipped Notion export folder and press Create.
Databases and CSV Files
Notion databases export as CSV files, often with Markdown files for database pages. Octarine does not turn CSV tables into native notes automatically.
For database exports, you can:
- Keep the CSV files as external reference files.
- Convert important rows into Markdown notes manually.
- Keep the page Markdown files and use properties or tags in Octarine to rebuild the parts you still need.
Attachments
Notion exports uploaded files and images alongside the generated Markdown. Move attachments into a .attachments folder at the root of your Octarine workspace, then update links if the paths changed.
If you keep Notion's exported folder structure, image links may already work. The .attachments cleanup is mostly useful when you want the workspace to follow Octarine's normal conventions.
Compatibility Notes
Basic pages, headings, lists, checklists, links, and code blocks usually move well. Notion callouts may export as HTML because there is no direct Markdown equivalent, and database views, relations, rollups, comments, page permissions, automations, and synced blocks do not become Octarine features.
For important dashboards or databases, keep the original Notion export ZIP as an archive until you have verified the migrated notes.