Obsidian
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.