> ## Documentation Index
> Fetch the complete documentation index at: https://learn.cleftnotes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obsidian

> Connect Cleft with Obsidian (macOS only) for seamless note syncing

<Note>
  The Obsidian integration is a **Plus feature** and currently only available on macOS. [Upgrade to Plus](/user-guides/upgrade-to-plus) to sync your notes with Obsidian. If you create a note on mobile, please add to it or regenerate on desktop to make it sync across.
</Note>

## Requirements

* [Front Matter Title Plugin](obsidian://show-plugin?id=obsidian-front-matter-title-plugin) installed in Obsidian

## Setup Guide

<Steps>
  <Step title="Open Cleft Settings and Connect">
    1. Open Cleft Settings (press `⌘ + ,` or click the gear icon)
    2. Go to the "Integrations" tab
    3. Click "Connect to Obsidian"
    4. You'll be prompted to select your Obsidian vault

           <img src="https://mintcdn.com/cleft/-qi9s0EeEIan3NrL/images/screenshots/integrations/cleft-obsidian-front-matter-select-your-vault.png?fit=max&auto=format&n=-qi9s0EeEIan3NrL&q=85&s=77736ccf8ec760a1e1df341b25195bef" alt="Cleft macOS Integrations settings showing Obsidian connection option with Connect button" width="737" height="687" data-path="images/screenshots/integrations/cleft-obsidian-front-matter-select-your-vault.png" />
  </Step>

  <Step title="Select Your Obsidian Vault Folder">
    Select where your Cleft notes will be saved as markdown files in your Obsidian vault:

    1. Create a dedicated folder for your Cleft notes (e.g., "Cleft", "Voice Notes", "Cleft Notes", or "Inbox")
    2. This folder will contain all your Cleft notes synced as .md files
    3. Select this folder when connecting Cleft to Obsidian

    Example folder setup:

    <img src="https://mintcdn.com/cleft/-qi9s0EeEIan3NrL/images/screenshots/integrations/cleft-obsidian-tutorial-cleft-inbox.png?fit=max&auto=format&n=-qi9s0EeEIan3NrL&q=85&s=ed4a8fc750750b0daa13044e5935b242" alt="macOS Finder showing a Cleft Inbox folder selected inside an Obsidian vault directory" width="1144" height="712" data-path="images/screenshots/integrations/cleft-obsidian-tutorial-cleft-inbox.png" />

    <Note>
      Cleft uses one-way sync: changes made in Cleft will sync to Obsidian, but changes made in Obsidian will not sync back to Cleft. Audio recordings stay in Cleft - only the transcribed text syncs to Obsidian.
    </Note>
  </Step>

  <Step title="Install Front Matter Title Plugin">
    Install the Front Matter Title plugin from Obsidian's community plugins:

    <img src="https://mintcdn.com/cleft/Gpj6Dh1xKBZ-uU2g/images/screenshots/integrations/cleft-obsidian-front-matter-tutorial-options.png?fit=max&auto=format&n=Gpj6Dh1xKBZ-uU2g&q=85&s=e202f47c9ede65525a399c3bf81fb41b" alt="Obsidian community plugins browser with Front Matter Title plugin selected and install button highlighted" width="1984" height="1177" data-path="images/screenshots/integrations/cleft-obsidian-front-matter-tutorial-options.png" />
  </Step>

  <Step title="Configure Plugin Settings">
    Once installed, enable all settings in the Front Matter Title plugin configuration:

    <img src="https://mintcdn.com/cleft/-qi9s0EeEIan3NrL/images/screenshots/integrations/cleft-obsidian-front-matter-settings.png?fit=max&auto=format&n=-qi9s0EeEIan3NrL&q=85&s=4367d0bc3549ad78af7bbd71faca736f" alt="Front Matter Title plugin Features settings with all toggles enabled including Explorer, Graph, Header, Bookmarks, Search, Tabs, and Backlink" width="653" height="727" data-path="images/screenshots/integrations/cleft-obsidian-front-matter-settings.png" />

    Make sure all options are enabled (turned on):

    Before enabling:

    <img src="https://mintcdn.com/cleft/-qi9s0EeEIan3NrL/images/screenshots/integrations/cleft-obsidian-front-matter-tutorial-turned-off.png?fit=max&auto=format&n=-qi9s0EeEIan3NrL&q=85&s=cab7140db16b20a1dbcd27d1c12e2696" alt="Split view of Cleft, Obsidian, and Finder showing notes displayed with raw filenames before enabling Front Matter Title" width="1920" height="1080" data-path="images/screenshots/integrations/cleft-obsidian-front-matter-tutorial-turned-off.png" />

    After enabling all settings:

    <img src="https://mintcdn.com/cleft/-qi9s0EeEIan3NrL/images/screenshots/integrations/cleft-obsidian-front-matter-tutorial-turned-on.png?fit=max&auto=format&n=-qi9s0EeEIan3NrL&q=85&s=c99cbf62899c129b26eeb4378440c109" alt="Split view of Cleft, Obsidian, and Finder showing notes displayed with proper titles after enabling Front Matter Title" width="1920" height="1080" data-path="images/screenshots/integrations/cleft-obsidian-front-matter-tutorial-turned-on.png" />
  </Step>
</Steps>