diff --git a/doc/update/8.17-to-9.0.md b/doc/update/8.17-to-9.0.md
index 277d24f989fcc6af3700e5eaf3f6e33f807bf09b..e268a7c12efdb197a23495d833ae70a24a5438aa 100644
--- a/doc/update/8.17-to-9.0.md
+++ b/doc/update/8.17-to-9.0.md
@@ -62,15 +62,15 @@ from source at the nodejs.org website.
 <https://nodejs.org/en/download/>
 
 
-Since GitLab 8.17, GitLab requires the use of yarn yarn >= v0.17.0  to manage
-javascript dependencies.
+Since 8.17, GitLab requires the use of yarn `>= v0.17.0` to manage
+JavaScript dependencies.
 
-    # install yarn
-    curl --location https://yarnpkg.com/install.sh | bash -
-
-More information can be found on the yarnpkg.com website.
+```bash
+# install yarn
+curl --location https://yarnpkg.com/install.sh | bash -
+```
 
-<https://yarnpkg.com/en/docs/install>
+More information can be found on the [yarn website](https://yarnpkg.com/en/docs/install).
 
 ### 5. Get latest code