diff --git a/README.adoc b/README.adoc
deleted file mode 100644
index fc7fabf835..0000000000
--- a/README.adoc
+++ /dev/null
@@ -1,12 +0,0 @@
-= Groovy Server Pages (GSP) [![Java CI](https://github.com/grails/grails-gsp/actions/workflows/gradle.yml/badge.svg)](https://github.com/grails/grails-gsp/actions/workflows/gradle.yml)
-
-This project contains the sources for GSP, the server-side view rendering technology used in http://grails.org[Grails].
-
-== Documentation
-
-* Latest - https://gsp.grails.org
-* Latest - https://gsp.grails.org/latest/api
-
-
-* Snapshot Guide - https://gsp.grails.org/snapshot
-* Snapshot API - https://gsp.grails.org/snapshot
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..fd10b8a146
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Groovy Server Pages (GSP) [![Java CI](https://github.com/grails/grails-gsp/actions/workflows/gradle.yml/badge.svg?event=push)](https://github.com/grails/grails-gsp/actions/workflows/gradle.yml)
+
+This project contains the sources for GSP, the server-side view rendering technology used in the [Grails framework](https://grails.org).
+
+## Documentation
+
+* Latest - https://gsp.grails.org
+* Latest - https://gsp.grails.org/latest/api
+
+
+* Snapshot Guide - https://gsp.grails.org/snapshot
+* Snapshot API - https://gsp.grails.org/snapshot