Skip to content

Search Documentation

Search across all documentation pages

Importing Data

ExoVault supports importing existing notes and knowledge from external tools. You can bring in your Obsidian vault, upload files, or migrate from other note-taking systems.

Obsidian Import#

ExoVault has first-class support for Obsidian vault imports. The importer preserves your folder structure, wiki-links, tags, and markdown content.

How to Import#

  1. Open the ExoVault dashboard
  2. Navigate to Import > Obsidian
  3. Select your Obsidian vault folder
  4. Review the import preview (files, folders, wiki-links)
  5. Click Import to start

What Gets Imported#

  • Markdown files -- Each .md file becomes an encrypted ExoVault note
  • Folder structure -- Obsidian folders are recreated as ExoVault folders
  • Wiki-links -- [[Link]] references are preserved and resolved in the knowledge graph
  • Tags -- Obsidian tags (#tag) are extracted and stored as encrypted note tags
  • Frontmatter -- YAML frontmatter is parsed for metadata

What to Know#

  • All content is encrypted client-side before upload -- the server never sees plaintext
  • Large vaults are processed in batches to avoid timeouts
  • Duplicate detection prevents re-importing the same files
  • Attachments (images, PDFs) referenced in notes are noted but not imported as separate files

Obsidian Sync#

Beyond one-time import, ExoVault supports ongoing sync with Obsidian:

  1. Navigate to Sync > Obsidian in the dashboard
  2. Select your vault folder
  3. Review changes (new, modified, deleted files)
  4. Confirm the sync

Sync detects changes since the last import and applies them incrementally.

Notion Import#

To import from Notion:

  1. Export your Notion workspace as Markdown & CSV from Notion settings
  2. Unzip the exported archive
  3. Use the ExoVault dashboard importer to upload the exported folder
  4. Notes, databases (as tables), and nested pages are imported

Tip: Notion exports can have deeply nested folder structures. ExoVault preserves the hierarchy.

File Upload#

Upload individual files directly to a vault:

Supported Formats#

FormatExtensionNotes
Markdown.mdDirect import, preserves formatting
PDF.pdfText extracted and stored as note content
Word.docxContent extracted, formatting simplified
Plain text.txtImported as-is

Upload via Dashboard#

  1. Open a vault in the dashboard
  2. Click New Note > Upload
  3. Select one or more files
  4. Files are processed, encrypted, and stored as notes

Migration Strategies#

From Another Note App#

  1. Export your data as Markdown files (most apps support this)
  2. Organize the files into folders matching your desired structure
  3. Use the Obsidian importer (it works with any folder of Markdown files)

From a Knowledge Base#

  1. Export content as Markdown or structured text
  2. Import via file upload
  3. Use agents to create memories from the imported notes
  4. Let the knowledge graph build connections automatically via wiki-links

Incremental Migration#

For large knowledge bases, consider migrating incrementally:

  1. Start with the most actively used notes
  2. Let agents discover and reference imported content
  3. Add more content as needed
  4. Use search_and_read to verify imported content is findable

Post-Import#

After importing, the extraction pipeline processes your notes:

  1. Embedding generation -- Notes are chunked and embedded for semantic search
  2. Wiki-link resolution -- [[links]] are resolved to actual note connections
  3. Blind index generation -- Privacy-preserving keyword tokens are created

Check the Memory Health panel in the dashboard to monitor embedding indexing progress.

Next Steps#