---
title: Obsidian
description: Quickly setup your existing Obsidian vault as a workspace in Octarine
---

Moving from Obsidian to Octarine? Since both apps use standard markdown files stored locally, migration is pretty straightforward. You can turn your existing vault into an Octarine workspace with just a few adjustments.

### Direct Migration

The quickest way is to create a workspace from your existing Obsidian vault:

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?**. Navigate to your Obsidian vault and press Create. That's it—Octarine will start using your vault as a workspace.

### Adjusting the Folder Structure

Octarine has a few conventions that might differ from your Obsidian setup. Here's what to check:

**Attachments:** If your vault uses a different attachment folder, create a `.attachments` folder in your vault root and move all images and media there. Octarine expects attachments to be referenced as `[[filename.png]]`, so you might need to update some links.

**Linked Notes:** Obsidian gives you options for how to store wikilinks, but Octarine is stricter. Notes need to include the entire path (except the workspace path) in the link. For example, a note called `Hello` inside a folder called `New Folder` should be linked as `[[New Folder/Hello]]`. If you just write `[[Hello]]`, Octarine will look for it in the root folder, not in nested folders.

**Templates:** If you use templates, create a `.templates` folder in your vault root and move your template files there.

**Daily Notes:** If your daily notes aren't already in a `Daily` folder, create one and move them there. Make sure they follow the `YYYY-MM-DD.md` naming format so Octarine can recognize them.

### Compatibility Notes

Octarine supports Obsidian's `[[wikilink]]` syntax natively, though aliases aren't supported yet. Absolute paths are required for storage, but you can change the setting for how they're displayed in the UI.

Tags work seamlessly—both `#tag` and `#nested/tag` formats are fully supported.

#### Quick Answers

### Can Octarine open an Obsidian vault?

Yes. You can create an Octarine workspace from an existing Obsidian vault because both apps use local Markdown files.

### Do Obsidian wikilinks work in Octarine?

Octarine supports Obsidian-style `[[wikilink]]` syntax, but links should include the full path inside the workspace so Octarine can resolve nested notes reliably.

### Do I need to export from Obsidian first?

Usually no. If your vault is already a folder of Markdown files, point Octarine at the existing folder and adjust attachments, templates, and daily notes as needed.