# Obsidian Configuration Tutorial

Cherry Studio supports integration with Obsidian, allowing you to export complete conversations or individual conversations into an Obsidian vault.

{% hint style="warning" %}
This process does not require installing any additional Obsidian plugins. However, since Cherry Studio uses a principle similar to Obsidian Web Clipper when importing into Obsidian, it is recommended that users upgrade Obsidian to the latest version (the current Obsidian version should be at least greater than **1.7.2**) to avoid[import failure caused by overly long conversations](https://github.com/obsidianmd/obsidian-clipper/releases/tag/0.7.0).
{% endhint %}

## Latest tutorial

{% hint style="info" %}
Compared with the old version of exporting to Obsidian, the new export-to-Obsidian feature can automatically select the vault path, and no longer requires manually entering the vault name or folder name.
{% endhint %}

### Step 1: Configure Cherry Studio

Open Cherry Studio's*Settings* → *Data Settings* → *Obsidian Configuration*menu, and the dropdown will automatically show the names of Obsidian vaults opened on this machine. Select your target Obsidian vault:

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-3cb6b0bc2f76f404c9d0084872625bb4952c8597%2Fimage%20(142).png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 2: Export a conversation

#### Export complete conversation

Go back to Cherry Studio's conversation interface, right-click the conversation, and select*Export*, then click*Export to Obsidian*:

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-903686a04872a6d08587f211148f90b06dc763b3%2Fimage%20(143).png?alt=media" alt=""><figcaption></figcaption></figure>

A window will then pop up to adjust the **Properties,**&#x66;older location in Obsidian**where this conversation note will be placed**and the**handling method for exporting to Obsidian:**

* **Vault**: Click the dropdown menu to choose another Obsidian vault
* **Path**: Click the dropdown menu to choose the folder where the exported conversation note will be stored
* As Obsidian note properties (Properties):
  * Tags
  * Creation time (created)
  * Source (source)
* The**handling method for exporting to Obsidian**has the following three options:
* The**handling method for exporting to Obsidian**has the following three options:
  * **New (overwrite if it exists)**: Create a new conversation note in the**Path**vault filled in at`Open the system prompt file in the folder (for example` ; if a note with the same name already exists, the old note will be overwritten
  * **Prefix**: If a note with the same name already exists, export the selected conversation content and add it to the beginning of that note
  * **Append**: If a note with the same name already exists, export the selected conversation content and add it to the end of that note

{% hint style="info" %}
Only the first method will include Properties; the latter two methods will not include Properties.
{% endhint %}

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-7240953b9be1f2b6c0b06a42d0b395450caa361a%2Fimage%20(144).png?alt=media" alt=""><figcaption><p>Configure note properties</p></figcaption></figure>

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-67e8c20eef26aff0c1285a642f196db87000e812%2Fimage%20(145).png?alt=media" alt=""><figcaption><p>Select path</p></figcaption></figure>

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-0c32c82015908e879cecff704e7d6474c65ed897%2Fimage%20(146).png?alt=media" alt=""><figcaption><p>Select handling method</p></figcaption></figure>

After selecting all options, click Confirm to export the complete conversation to the corresponding folder in the corresponding Obsidian vault.

#### Export a single conversation

For exporting a single conversation, click the*three-line menu*, select*Export*, then click*Export to Obsidian*:

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-761a8cb4ea7dffa9f9ab1f0421460af15c650a8c%2Fimage%20(147).png?alt=media" alt=""><figcaption><p>Export a single conversation</p></figcaption></figure>

Then a window like the one used for exporting a complete conversation will also pop up, asking you to configure**note properties**and**the note's handling method**; just follow the[tutorial above](#dao-chu-wan-zheng-dui-hua)to complete it.

### Export successful

🎉 Congratulations! You have now finished all the configuration for Cherry Studio to work with Obsidian, and completed the full export process. Enjoy yourselves!

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-2a4f59cb2e9cd3f16c41ddea10d5707d7dc29696%2Fimage%20(140).png?alt=media" alt=""><figcaption><p>Export to Obsidian</p></figcaption></figure>

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-a086a57fc3fc0b3b1420d6f1e933e003d69c6707%2Fimage%20(139).png?alt=media" alt=""><figcaption><p>View export results</p></figcaption></figure>

***

## Old tutorial (applicable to Cherry Studio < v1.1.13)

### Step 1: Prepare Obsidian

Open the Obsidian vault and create a`Open the system prompt file in the folder (for example`for saving exported conversations (the image uses a Cherry Studio folder as an example):

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-6ebd691ec21477891a6d5489c887269f156dc0a1%2Fimage%20(127).png?alt=media" alt=""><figcaption></figcaption></figure>

Remember the text highlighted in the lower-left corner; this is your`Vault`name.

### Step 2: Configure Cherry Studio

In Cherry Studio's*Settings* → *Data Settings* → *Obsidian Configuration*menu, enter the[Step 1](#di-yi-bu)obtained in`Vault`name and`Open the system prompt file in the folder (for example`name:

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-30857ea752f4ad3813cbec3934c0da4c9f5cd52c%2Fimage%20(129).png?alt=media" alt=""><figcaption></figcaption></figure>

`Global tags`is optional here; you can set tags for all conversations in Obsidian after export, and fill it in as needed.

### Step 3: Export a conversation

#### Export complete conversation

Go back to Cherry Studio's conversation interface, right-click the conversation, and select*Export*, then click*Export to Obsidian*.

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-dff2d3430b91d456833115cb512ee5892f54ff83%2Fimage%20(138).png?alt=media" alt=""><figcaption><p>Export complete conversation</p></figcaption></figure>

A window will then pop up to adjust the **Properties**and the**handling method for exporting to Obsidian**export to Obsidian. The**handling method for exporting to Obsidian**has the following three options:

* **New (overwrite if it exists)**: Create a new conversation note in the[Step 2](#di-er-bu)filled in in`Open the system prompt file in the folder (for example` ; if a note with the same name already exists, the old note will be overwritten
* **Prefix**: If a note with the same name already exists, export the selected conversation content and add it to the beginning of that note
* **Append**: If a note with the same name already exists, export the selected conversation content and add it to the end of that note

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-77015543fcd5753d8c84ab855c9b0cf7b096f6ad%2Fimage%20(137).png?alt=media" alt=""><figcaption><p>Configure note properties</p></figcaption></figure>

{% hint style="info" %}
Only the first method will include Properties; the latter two methods will not include Properties.
{% endhint %}

#### Export a single conversation

For exporting a single conversation, click the*three-line menu*, select*Export*, then click*Export to Obsidian*.

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-c3dba078462c9bd247b227c74826f3eca7e770b8%2Fimage%20(141).png?alt=media" alt=""><figcaption><p>Export a single conversation</p></figcaption></figure>

Then a window like the one used for exporting a complete conversation will also pop up, asking you to configure**note properties**and**the note's handling method**; just follow the[tutorial above](#dao-chu-wan-zheng-dui-hua)to complete it.

### Export successful

🎉 Congratulations! You have now finished all the configuration for Cherry Studio to work with Obsidian, and completed the full export process. Enjoy yourselves!

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-2a4f59cb2e9cd3f16c41ddea10d5707d7dc29696%2Fimage%20(140).png?alt=media" alt=""><figcaption><p>Export to Obsidian</p></figcaption></figure>

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-a086a57fc3fc0b3b1420d6f1e933e003d69c6707%2Fimage%20(139).png?alt=media" alt=""><figcaption><p>View export results</p></figcaption></figure>
