Import from Obsidian or a folder of notes

A vault is the folder where Obsidian keeps your notes. Markdown notes are plain-text files ending in .md. Zip that folder to bring its notes and attachments together.

Zip your notes

On a Mac, right-click the folder in Finder and choose the option to compress it. Keep the zip file it creates. Files and folders whose names start with a dot, including Obsidian’s settings and trash, are left out of the import.

Import into Stuga

1. Open the workspace switcher in the top bar and choose Create workspace.

2. Under Start with, choose Import, then select the zip.

3. Enter a Workspace name, or leave it empty to use the folder’s name.

4. Under Who can use new documents?, choose the sharing you want.

5. Choose Create workspace.

   If some files will be left out, Stuga lists them first. Choose Import to continue, or Cancel.

The workspace opens when the import finishes. You own its content.

Good to know

In your notes	In Stuga
Folder containing notes	Folder
Note	Document, named from its first-level heading, then its title property, then its file name
Link to another note	Link to that document; heading links open the document
Link to a missing note	The link’s text
Embedded image	Image
Embedded note	Link to the document
Embedded or linked file	Attached file link
Callout	Quote with a bold title
Highlight	Bold text

Obsidian comments, block IDs and properties are left out. Keep your original notes if you need those details.

The default attachment limit is 10 MB per file. Files over the limit, unreferenced files and oversized notes are left out; Stuga lists them before you confirm. Check links and attachments in the new workspace before sharing it with others.

Next

• Invite people — bring people into the new workspace.
• Import from Notion — bring in a Notion export.
• Export a workspace — take your work back out.

More detail for people who run servers: Importing on GitHub.