Skip to content

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.

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.

  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 Access for new documents, choose who can open the imported items.

  5. Choose Create workspace.

    If some files will be left out, Stuga lists them first, each with why. Choose Import to continue, or Back.

  6. A summary says what came in and what changed on the way in. Choose Open workspace.

You own the new workspace’s content.

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
Properties A list under the title
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
Task, done or not Task, ticked or not
Math Its text

Obsidian comments and block IDs 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, files no note links to, unreadable images, oversized notes and notes that aren’t plain text are left out; Stuga lists them before you confirm. Check links and attachments in the new workspace before sharing it with others.

More detail: Importing on GitHub.