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

# Obsidian

> Import your vault from Obsidian into Craft with backlinks and attachments.

If you're moving from Obsidian to Craft, here's a simple guide to import your content.

## Locate your Obsidian Vault Folder on Mac using Spotlight Search

<Steps>
  <Step>
    **Press `Cmd + Space`** to open Spotlight Search on your Mac.
  </Step>

  <Step>
    **Type the name of your Obsidian Vault** into the search bar (e.g., "Obsidian Vault").
  </Step>

  <Step>
    **Select the vault folder** from the search results to open it in Finder.
  </Step>

  <Step>
    **Verify the contents**

    Inside the folder, verify that it contains your Markdown files (`.md`) and any associated media, such as images or PDFs.

    <img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/import-and-export/import/obsidian/en/content/obsidian-vault-location.png?fit=max&auto=format&n=bXGV3J9qfsAQZqJz&q=85&s=c21d1daa1203321282cbc5323c324f83" alt="Obsidian vault folder in Finder" width="1307" height="404" data-path="images/import-and-export/import/obsidian/en/content/obsidian-vault-location.png" />
  </Step>
</Steps>

## Import the Vault into Craft

<Steps>
  <Step>
    **Open the Craft app** on your Mac, iPad, or iPhone.
  </Step>

  <Step>
    **Navigate** to the **"Organize"** or **"All Documents"** view in Craft.
  </Step>

  <Step>
    **Import your files**

    You 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

            <img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/import-and-export/import/obsidian/en/content/obsidian-import-menu.png?fit=max&auto=format&n=bXGV3J9qfsAQZqJz&q=85&s=d2a4afd0d11b5b79cc7ca1eb08a51221" alt="Import menu in Craft" width="1273" height="939" data-path="images/import-and-export/import/obsidian/en/content/obsidian-import-menu.png" />
  </Step>
</Steps>

## 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.

<Info title="Notes and tips">
  - **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.
</Info>
