docs: add img alias change, close #1373

vuepress · Oct 10, 2023 · 9877c99 · 9877c99
1 parent f342a86
commit 9877c99
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 4 deletions.
diff --git 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
@@ -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 变更