> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/data-settings/obsidian.md). # Obsidian Configuration Guide Cherry Studio supports integration with Obsidian, allowing you to export a full conversation or a single conversation to an Obsidian vault. {% hint style="warning" %} This process does not require installing any additional Obsidian plugins. However, because the principle Cherry Studio uses to import into Obsidian is similar to Obsidian Web Clipper, 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 a conversation being too long](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, no longer requiring manual entry of the vault name or folder name. {% endhint %} ### Step 1: Configure Cherry Studio Open Cherry Studio's*Settings* → *Data Settings* → *Obsidian Configuration*menu; the drop-down list will automatically show the names of Obsidian vaults that have been opened on this computer. Select your target Obsidian vault:

### Step 2: Export the conversation #### Export full conversation Return to the conversation interface in Cherry Studio, right-click the conversation, and select*Export*, click*Export to Obsidian*:

A window will pop up to adjust the **Properties,**located in Obsidian **folder location** as well as the **processing method for exporting to Obsidian:** * **Vault**: Click the drop-down menu to select another Obsidian vault * **Path**: Click the drop-down menu to select the folder where the exported conversation note will be stored * As Obsidian note properties (Properties): * Tags * Created time (created) * Source (source) * The **processing method** for exporting to Obsidian has the following three options: * The **processing method** for exporting to Obsidian has the following three options: * **New (overwrite if it exists)**: switch between **Path** entered in the `folder` Create a new conversation note in the folder entered here; if a note with the same name already exists, it will overwrite the old note * **Prefix**: If a note with the same name already exists, export and append the selected conversation content to the beginning of that note * **Append**: If a note with the same name already exists, export and append the selected conversation content 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 %}

After selecting all options, click OK to export the full conversation to the corresponding folder in the corresponding Obsidian vault. #### Export single conversation For exporting a single conversation, click the*three-line menu*, choose*Export*, click*Export to Obsidian*:

below the conversation; a window similar to the one for exporting a full conversation will also pop up, asking you to configure **note properties** and **the note processing method**, and just follow [the tutorial above](#dao-chu-wan-zheng-dui-hua) to complete it. ### Export successful 🎉 At this point, congratulations on completing all the configuration for Cherry Studio integration with Obsidian, and going through the entire export process—enjoy yourselves!

*** ## Old tutorial (applicable to Cherry Studio < v1.1.13) ### Step 1: Prepare Obsidian Open the Obsidian vault and create a`folder`(the image uses the Cherry Studio folder as an example):

Note the text boxed in the lower-left corner; this is your `Vault` name. ### Step 2: Configure Cherry Studio In Cherry Studio's \[Settings] → \[Data] → \[Obsidian Configuration], just select **Default Obsidian vault**: Cherry Studio will automatically detect the Obsidian vaults already on this computer; just select the one you want to use from the drop-down list.

[Settings] → [Data] → [Obsidian Configuration]: Select default Obsidian vault

{% hint style="info" %} Only the default vault is set here.**The specific folder to save to and what tags to add are selected in the \[Configure note properties] dialog that pops up each time you export**(see the next step); there is no need to fill them in beforehand in Settings. If the drop-down shows "No Obsidian vault found", please first confirm that Obsidian is installed on this computer and that at least one vault has been created. {% endhint %} ### Step 3: Export conversation #### Export full conversation Return to the conversation interface in Cherry Studio, right-click the conversation, and select*Export*, click*Export to Obsidian*. A window will pop up to adjust the **Properties**, and the **processing method**. In the export to Obsidian **processing method** for exporting to Obsidian has the following three options: * **New (overwrite if it exists)**: switch between [Step 2](#di-er-bu) filled in `folder` Create a new conversation note in the folder entered here; if a note with the same name already exists, it will overwrite the old note * **Prefix**: If a note with the same name already exists, export and append the selected conversation content to the beginning of that note * **Append**: If a note with the same name already exists, export and append the selected conversation content 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 %} #### Export single conversation For exporting a single conversation, click the*three-line menu*, choose*Export*, click*Export to Obsidian*.

*** ### Get help and submit feedback If you encounter any questions, bugs, or have suggestions for feature improvements during configuration or use, please refer to [Feedback and Suggestions](/docs/en-us/question-contact/suggestions.md) for the official channels provided. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/data-settings/obsidian.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.