diff --git a/docs/guide/migrate.md b/docs/guide/migrate.md
index 9de32efd1..34e8d4cef 100644
--- a/docs/guide/migrate.md
+++ b/docs/guide/migrate.md
@@ -8,15 +8,15 @@ We suggest you to migrate step by step, following each version's migration guide
 
 ## Migrate from v3.0
 
-If you are on v3.0, v4.0 only drops support for Node.js 18 and remove deprecated APIs, so you should be able to directly bump to v4.0. Read [Shiki v4.0](/blog/v4) for more details.
+If you are on v3.0, v4.0 only drops support for Node.js 18 and remove deprecated APIs, so you should be able to directly bump to v4.0. Read [Shiki v4.0](/blog/v4.md) for more details.
 
 ## Migrate from v2.0
 
-If you are on v2.0 and there is no warning in your usage, you should be able to directly bump to v3.0, read [Shiki v3.0](/blog/v3) for more details.
+If you are on v2.0 and there is no warning in your usage, you should be able to directly bump to v3.0, read [Shiki v3.0](/blog/v3.md) for more details.
 
 ## Migrate from v1.0
 
-We recommend you to [migrate to v2.0 first](/blog/v2), then to v3.0.
+We recommend you to [migrate to v2.0 first](/blog/v2.md), then to v3.0.
 
 ## Migrate from v0.14