> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Import from Obsidian

> Import your Obsidian vault — notes, attachments, and images — directly into Craft.

## How to Start the Import

Go to the [import page](https://docs.craft.do/import/obsidian) to get started.

## Locate Your Obsidian Vault

Your vault is a folder on your computer containing your Markdown notes and attachments.

<Tabs>
  <Tab title="macOS">
    Press **Cmd + Space** to open Spotlight Search, type the name of your vault, and select it to reveal it in Finder.
  </Tab>

  <Tab title="Windows">
    Open File Explorer and search for your vault folder name, or check **Obsidian → Settings → About** for the vault's file path.
  </Tab>
</Tabs>

## Import Your Vault

<Steps>
  <Step title="Upload your vault">
    Drag and drop your entire vault folder onto the upload area on the import page, or click to browse and select it.
  </Step>

  <Step title="Choose your destination">
    Select the **Craft Space** where you want your Obsidian notes to appear. Optionally select a **destination folder** to organize your imported notes.
  </Step>

  <Step title="Start the import">
    Click **Import**. You'll see a progress bar as your vault is uploaded and imported. You can close the page at any time — the import will continue in the background.
  </Step>
</Steps>

Craft brings over your entire vault in one go, including:

* All Markdown notes, converted into Craft documents
* Images and other attachments, embedded in place
* Your folder structure, preserved as nested documents

## After the Import

Once complete, you'll see a confirmation with a button that takes you to Craft, where you'll find your imported documents.

<Info title="Notes and tips">
  * **Backlinks**: Links between your Obsidian notes are preserved as links between the corresponding Craft documents.
  * **Backup your vault**: Before importing, it's a good idea to keep a backup of your Obsidian vault.
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Some attachments are missing">
    Make sure all media files referenced by your notes are stored inside the vault folder you uploaded. Attachments outside the vault folder won't be included.
  </Accordion>

  <Accordion title="Import failed">
    Try restarting the import. If the issue persists, contact support.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.