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
 
 - 详情：