diff --git a/vcl/README.GDIMetaFile b/vcl/README.GDIMetaFile.md
similarity index 100%
rename from vcl/README.GDIMetaFile
rename to vcl/README.GDIMetaFile.md
diff --git a/vcl/README.lifecycle b/vcl/README.lifecycle.md
similarity index 100%
rename from vcl/README.lifecycle
rename to vcl/README.lifecycle.md
diff --git a/vcl/README.md b/vcl/README.md
index 63eb77d67405..66d4c1bd20b3 100644
--- a/vcl/README.md
+++ b/vcl/README.md
@@ -245,7 +245,7 @@ In short, never hold any mutex unless necessary, especially not when calling
 out.
 
 ## Read More
-* [Environment variables in VCL](README.vars)
-* [GDIMetaFile class](README.GDIMetaFile)
-* [Understanding transitional VCL lifecycle](README.lifecycle)
-* [VCL scheduler](README.scheduler)
+* [Environment variables in VCL](README.vars.md)
+* [GDIMetaFile class](README.GDIMetaFile.md)
+* [Understanding transitional VCL lifecycle](README.lifecycle.md)
+* [VCL scheduler](README.scheduler.md)
diff --git a/vcl/README.scheduler b/vcl/README.scheduler.md
similarity index 100%
rename from vcl/README.scheduler
rename to vcl/README.scheduler.md
diff --git a/vcl/README.vars b/vcl/README.vars.md
similarity index 100%
rename from vcl/README.vars
rename to vcl/README.vars.md