Bringing an Obsidian vault into Deckle is a single folder import. Your notes, subfolders, and the [[wikilinks]] between them all come across, landing in Deckle's Research area rather than as one flat dump.
What You'll Need
- Your Obsidian vault's folder on disk (or the specific subfolder of it you want to bring over).
Step-by-Step: Importing Your Vault
- Open Deckle's Binder and go to the Research section.
- Open Research's add menu and choose "Import Markdown Folder…"
- Select your Obsidian vault folder (or a subfolder of it, if you only want part of it). Deckle imports it into Research, preserving the folder structure exactly.
- Check your links.
[[Wikilinks]]between notes are resolved automatically during import, matched by filename, the same way Obsidian itself resolves them.
What Carries Over, and What Doesn't
Carries over:
- Subfolder structure, exactly as it was in your vault.
[[Wikilinks]]between notes, resolved automatically.- Embeds and callouts.
- Non-markdown files sitting in your vault (images, PDFs, and similar), imported as real attached files, not dropped.
Doesn't carry over:
- Tables: not supported yet, and are skipped entirely on import.
- Code blocks and tags: these import as plain text rather than being specially converted or preserved as Obsidian-style tags.
Common Mistakes
- Expecting a single loose
.mdfile to import the same way. This is specifically a folder import. A lone file has no other notes for its wikilinks to resolve against, so it isn't available from the same menu. - Assuming tables will show up somewhere. They're silently skipped, not converted to a rough approximation. If a note relies heavily on tables, check it after import and rebuild that content manually if needed.
- Not double-checking duplicate note names. If two different notes in different subfolders share the same filename (uncommon, but it happens in large vaults), wikilinks pointing to that name resolve to whichever one Deckle happened to import first.
FAQ
Do my Obsidian wikilinks still work after importing into Deckle?
Yes, [[wikilinks]] are resolved during import, matched by filename the same way Obsidian resolves them itself.
Will my vault's folder structure be preserved?
Yes, exactly. Subfolders in your vault become real folders in Deckle's Research area.
What happens to tables in my notes?
They're not supported yet and are skipped on import, worth checking any table-heavy notes afterward and rebuilding that content by hand if you need it.
Does this import into my manuscript (Draft), or somewhere else?
Research. This import path is specifically for reference/notes material, not your manuscript itself.