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
Section titled “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
Section titled “Import into Stuga”-
Open the workspace switcher in the top bar and choose Create workspace.
-
Under Start with, choose Import, then select the zip.
-
Enter a Workspace name, or leave it empty to use the folder’s name.
-
Under Access for new documents, choose who can open the imported items.
-
Choose Create workspace.
If some files will be left out, Stuga lists them first, each with why. Choose Import to continue, or Back.
-
A summary says what came in and what changed on the way in. Choose Open workspace.
You own the new workspace’s content.
Good to know
Section titled “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 |
| 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.
- 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: Importing on GitHub.