From 1b677c10461b2d31dfce47dd531482bd515a641a Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 6 Dec 2024 22:00:39 +0800
Subject: [PATCH 1/2] docs: add `onContentUpdated`

---
 docs/reference/client-api.md    | 20 +++++++++++++++++++-
 docs/zh/reference/client-api.md | 20 +++++++++++++++++++-
 2 files changed, 38 insertions(+), 2 deletions(-)

diff --git a/docs/reference/client-api.md b/docs/reference/client-api.md
index ebfc4d7a..96a4dc27 100644
--- a/docs/reference/client-api.md
+++ b/docs/reference/client-api.md
@@ -106,6 +106,24 @@ const {
 
   The properties of current locale have been merged into the root-level properties.
 
+### onContentUpdated
+
+- Details:
+
+  When the content of the markdown file changes, the callback is triggered.
+
+  This function can only be called during the `setup` phase of the component.
+
+  ```vue
+  <script setup>
+  import { onContentUpdated } from 'vuepress/client'
+
+  onContentUpdated(() => {
+    console.log('content updated')
+  })
+  </script>
+  ```
+
 ## Helpers
 
 ### defineClientConfig
@@ -126,7 +144,7 @@ const {
 - Also see:
   - [Advanced > Cookbook > Resolving Routes](../advanced/cookbook/resolving-routes.md)
 
-## resolveRoutePath
+### resolveRoutePath
 
 - Details:
 
diff --git a/docs/zh/reference/client-api.md b/docs/zh/reference/client-api.md
index c8b6deb5..b36cdd24 100644
--- a/docs/zh/reference/client-api.md
+++ b/docs/zh/reference/client-api.md
@@ -106,6 +106,24 @@ const {
 
   当前 locale 中的配置已经合并到顶层配置中。
 
+### onContentUpdated
+
+- 详情：
+
+  当 markdown 文件内容发生变化时，触发回调。
+
+  该函数仅能在组件的 `setup` 阶段被调用。
+
+  ```vue
+  <script setup>
+  import { onContentUpdated } from 'vuepress/client'
+
+  onContentUpdated(() => {
+    console.log('content updated')
+  })
+  </script>
+  ```
+
 ## 工具函数
 
 ### defineClientConfig
@@ -126,7 +144,7 @@ const {
 - 参考：
   - [深入 > Cookbook > 解析路由](../advanced/cookbook/resolving-routes.md)
 
-## resolveRoutePath
+### resolveRoutePath
 
 - 详情：
 

From 68a0d9b5235f1c25974e5fe37bf70d10bdb36e5a Mon Sep 17 00:00:00 2001
From: meteorlxy <meteor.lxy@foxmail.com>
Date: Sun, 23 Feb 2025 22:53:53 +0800
Subject: [PATCH 2/2] chore: updates

---
 docs/reference/client-api.md    | 4 ++--
 docs/zh/reference/client-api.md | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/reference/client-api.md b/docs/reference/client-api.md
index 96a4dc27..30b95266 100644
--- a/docs/reference/client-api.md
+++ b/docs/reference/client-api.md
@@ -118,8 +118,8 @@ const {
   <script setup>
   import { onContentUpdated } from 'vuepress/client'
 
-  onContentUpdated(() => {
-    console.log('content updated')
+  onContentUpdated((reason) => {
+    console.log(`content updated reason: ${reason}`)
   })
   </script>
   ```
diff --git a/docs/zh/reference/client-api.md b/docs/zh/reference/client-api.md
index b36cdd24..f2ae67d6 100644
--- a/docs/zh/reference/client-api.md
+++ b/docs/zh/reference/client-api.md
@@ -118,8 +118,8 @@ const {
   <script setup>
   import { onContentUpdated } from 'vuepress/client'
 
-  onContentUpdated(() => {
-    console.log('content updated')
+  onContentUpdated((reason) => {
+    console.log(`content updated reason: ${reason}`)
   })
   </script>
   ```