diff --git a/docs/guide/migration.md b/docs/guide/migration.md
index 9595bb17a4..6e0644291c 100644
--- a/docs/guide/migration.md
+++ b/docs/guide/migration.md
@@ -239,9 +239,13 @@ This directory will not be used as local theme implicitly if it is existed.
 
 You need to import and set your local theme via [theme](../reference/config.md#theme) option.
 
-### Markdown slot Change
+### Markdown Change
 
-Markdown slot is no longer supported.
+- Markdown slot is no longer supported.
+
+- Links behavior in Markdown image syntax are aligned with standard Markdown, this means they no longer support alias.
+
+  For `<img>` tags, only links starting with `.` are treated as relative links, which is the same as V1 behavior. You should use `<img>` tags instead if you want to use alias.
 
 ### CLI Change
 
diff --git a/docs/zh/guide/migration.md b/docs/zh/guide/migration.md
index ccb36f9ab6..03afd42726 100644
--- a/docs/zh/guide/migration.md
+++ b/docs/zh/guide/migration.md
@@ -239,9 +239,12 @@ VuePress v1 的 Stylus 调色板系统 （即 `styles/palette.styl` 和 `styles/
 
 你需要在 [theme](../reference/config.md#theme) 配置项中显式引入并使用本地主题。
 
-### Markdown 插槽变更
+### Markdown 变更
 
-Markdown 插槽不再被支持。
+- Markdown 插槽不再被支持。
+- Markdown 图片中的链接行为已与标准 Markdown 对齐，这意味着它们不在支持别名。
+
+  对于 `<img>` 标签，只有以 `.` 开头的链接才会被识别成相对路径，这与 V1 行为一致。如果你使用别名，你应该转用 `<img>` 标签。
 
 ### CLI 变更