diff --git a/surfsense_web/content/docs/connectors/obsidian.mdx b/surfsense_web/content/docs/connectors/obsidian.mdx
index a81475bfb..19c6a34c6 100644
--- a/surfsense_web/content/docs/connectors/obsidian.mdx
+++ b/surfsense_web/content/docs/connectors/obsidian.mdx
@@ -34,14 +34,12 @@ This works for cloud and self-hosted deployments, including desktop and mobile c
 
 ## Install via BRAT (recommended)
 
-1. In Obsidian, open **Settings → Community plugins** and install **BRAT**.
+1. In Obsidian, open **Settings → Community plugins** and install **[BRAT](obsidian://show-plugin?id=obsidian42-brat)**.
 2. Open BRAT settings and click **Add beta plugin** button.
-3. Paste the repository: `https://github.com/modsetter/SurfSense/`.
-4. Select the latest plugin version, then enable **SurfSense**.
+3. Paste the repository: `https://github.com/MODSetter/SurfSense/`.
+4. Select the latest plugin version, then click "Add plugin".
 5. Open **Settings → SurfSense** to finish setup.
 
-If BRAT is unavailable in your environment, use **Open plugin releases** in SurfSense and install manually from GitHub release assets.
-
 ## Migrating from the legacy connector
 
 If you previously used the legacy Obsidian connector architecture, migrate to the plugin flow: