diff --git a/Version-schemes.asciidoc b/Version-schemes.md
similarity index 75%
rename from Version-schemes.asciidoc
rename to Version-schemes.md
index 29192e3..61ec700 100644
--- a/Version-schemes.asciidoc
+++ b/Version-schemes.md
@@ -1,16 +1,19 @@
 We distinguish between *release* versions built from tags and *dev* versions built from tip of `main` branch.
 
-== preferred version scheme (semver)
+## preferred version scheme (semver)
 ```
 release version         : 0.25.0
 dev version (unique)    : 0.25.0-dev+6bd8216
 dev version (non-unique): 0.25.0-dev
+```
 
-== version scheme for maven (gradle build's `project.version` is set to this)
+## version scheme for maven (gradle build's `project.version` is set to this)
+```
 release version         : 0.25.0
 dev version (non-unique): 0.25.0-SNAPSHOT
+```
 
-== version scheme for (doc) urls
+## version scheme for (doc) urls
 
 ```
 release version               : .../0.25.0/...