diff --git a/lib/modules/manager/asdf/readme.md b/lib/modules/manager/asdf/readme.md
index 23dcb02114c6b4c8e4b9d79161449abae5d1a098..d2db91d440e01e7413f4f70af9581d949abf8f54 100644
--- a/lib/modules/manager/asdf/readme.md
+++ b/lib/modules/manager/asdf/readme.md
@@ -1,10 +1,10 @@
-Keeps the [asdf](https://asdf-vm.com/manage/configuration.html#tool-versions)
-`.tool-versions` file updated.
+Keeps the [asdf](https://asdf-vm.com/manage/configuration.html#tool-versions) `.tool-versions` file updated.
 
-Because `asdf` supports the version management of many different tools, specific tool support needs to be added one by one.
-
-Only the following tools are currently supported
+Because `asdf` supports versioning for many different tools, specific tool support must be added one-by-one.
+The following tools are currently supported:
 
 - [nodejs](https://github.com/asdf-vm/asdf-nodejs)
 
-NOTE: Because `.tool-versions` can support fallback versions only the first version entry for each supported tool is managed
+<!-- prettier-ignore -->
+!!! note
+    Only the first version entry for each supported tool is managed, this is because `.tool-versions` supports fallback versions.