---
title: UpNote
description: Export UpNote notes as Markdown and move them into Octarine
---

UpNote can export notes as Markdown, which gives you editable files that Octarine can use directly. Export notes as separate Markdown documents, then turn the export folder into an Octarine workspace.

### Export from UpNote

On desktop, export the notes, notebook, or full library you want to move.

- To export selected notes, select them in the note list and choose **Export**.
- To export a notebook, use the notebook menu and choose **Export**.
- To export everything on Mac, choose **File > Export all notes**.
- To export everything on Windows, go to **Settings > General > Export all notes**.

Choose **Markdown (.md)** and export notes as separate files when that option is available.

### Create an Octarine Workspace

After the export finishes, open the exported folder in Finder or your file manager. If UpNote created one folder containing your notes and a `Files` folder for attachments, keep them together while you clean up paths.

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 exported Markdown folder and press Create.

### Attachments

UpNote stores exported images and attachments in a `Files` folder inside the export. Octarine's convention is `.attachments` at the workspace root.

Rename or move `Files` to `.attachments`, then update any Markdown links that still point at the old folder name. For example:

```markdown
![Screenshot](Files/screenshot.png)
```

can become:

```markdown
[[Screenshot.png]]
```

### Notebooks and Nested Notes

If UpNote exports notebooks as folders, Octarine will show those folders in the file tree. If your export is flat, create folders manually and move related notes into them.

After moving notes into folders, check any internal note links. Octarine resolves wikilinks from the workspace root, so nested notes should be linked with their folder path.

### Compatibility Notes

Basic Markdown formatting, headings, checklists, tables, and tags should migrate well. UpNote-specific features such as notebook metadata, note colors, pinned state, backlinks, and publishing settings do not transfer as Octarine settings.

If a note relied heavily on rich formatting, compare it with the original after import and make small Markdown adjustments where needed.

#### Quick Answers

### Can I migrate UpNote notes to Octarine?

Yes. Export UpNote notes as separate Markdown files, then create an Octarine workspace from the export folder.

### Where do UpNote attachments go in Octarine?

Move UpNote's exported `Files` folder to `.attachments` at the workspace root, then update links if needed.

### Do UpNote notebooks transfer to Octarine folders?

If UpNote exports notebooks as folders, Octarine will show those folders in the file tree. If the export is flat, create folders manually.
