Markdown Folder Import in Deckle

Import a whole folder of markdown notes into Deckle's Research area in one step: subfolders preserved, [[wikilinks]] resolved between notes, and Obsidian-style embeds and callouts carried over, not flattened to plain text.

What You Can Do

• Import an entire folder of .md/.markdown files at once, subfolders and all. The structure lands in Research exactly as it was on disk.
• Have [[wikilink]]-style links between notes resolved automatically, the same way Obsidian resolves them (by filename, even when a note's displayed title comes from frontmatter).
• Keep embeds and callouts intact, not stripped or flattened.
• Have non-markdown files sitting alongside your notes (images, PDFs, and similar) imported as real attached files instead of silently skipped.

How to Import a Markdown Folder

1. In the Binder, open the Research section's add menu.
2. Choose Import Markdown Folder….
3. Select the folder. Deckle imports it into Research, preserving its subfolder structure.

What Actually Gets Imported

• Subfolders are preserved exactly, becoming real folders in Research.
• Each note's title comes from frontmatter if present, otherwise its filename. But wikilinks always resolve by filename specifically, matching Obsidian's own linking convention, since that's how Obsidian itself resolves [[links]], regardless of what a note's frontmatter title says.
• [[Wikilinks]], embeds, and callouts all carry over.
• Code blocks and tags import as plain text. They're not specially converted.
• Tables aren't supported yet and are skipped.
• Non-markdown files in the folder (images, PDFs, and similar) import as real attached files rather than being dropped.

A Couple of Things Worth Knowing

💡 This is a folder import, not a single-file import. A loose .md file on its own doesn't have other notes to resolve wikilinks against, so this specific import path is folder-based, reached from Research rather than the general Import dialog.

💡 Duplicate note names resolve to the first one found. If your notes folder has two different notes with the same filename in different subfolders (rare, but it happens in real vaults), wikilinks pointing to that name resolve to whichever one Deckle encountered first.