Skip to main content
If you’re moving from Obsidian to Craft, here’s a simple guide to import your content.
1
Press Cmd + Space to open Spotlight Search on your Mac.
2
Type the name of your Obsidian Vault into the search bar (e.g., “Obsidian Vault”).
3
Select the vault folder from the search results to open it in Finder.
4
Verify the contentsInside the folder, verify that it contains your Markdown files (.md) and any associated media, such as images or PDFs.Obsidian vault folder in Finder

​
Import the Vault into Craft

1
Open the Craft app on your Mac, iPad, or iPhone.
2
Navigate to the “Organize” or “All Documents” view in Craft.
3
Import your filesYou can either:
  • Drag and drop the vault folder or specific Markdown files directly into Craft, or
  • Use the Import function:
    • Go to three-dot menu (⋯) > Import > Markdown
    • Select the folder or Markdown files from your vault Import menu in Craft

​
Organize your imported content

  • Craft will automatically convert Markdown files into documents.
  • Media files (e.g., images) stored in the same folder will also be imported and embedded into the documents.
  • Folder structures from Obsidian will be preserved as nested documents in Craft.
  • Markdown Compatibility: Your text, links, headings, and lists will transfer seamlessly since Craft supports Markdown.
  • Attachments: Make sure all media files are stored in the same folder as the Markdown files for proper import.
  • Backup Your Vault: Before importing, create a backup of your Obsidian Vault to ensure your data is safe.