diff --git a/docs/dev.md b/docs/dev.md
index 2f3e24082052878ce9fe7d386acb756acc3a9232..79f2318019fcdfc6b550878532b3962d9d757304 100644
--- a/docs/dev.md
+++ b/docs/dev.md
@@ -76,7 +76,7 @@ Some light suggestions:
 
 ### Adding a new CLI command
 
-An example illustration on how to deal with [optparse-applicative](https://hackage.haskell.org/package/optparse-applicative) can be seen here: https://gitlab.haskell.org/haskell/ghcup-hs/-/commit/c19dd5ee8b2edbaf0336af143f1c75b6f4843e26
+An example illustration on how to deal with [optparse-applicative](https://hackage.haskell.org/package/optparse-applicative) can be seen here: [https://gitlab.haskell.org/haskell/ghcup-hs/-/commit/c19dd5ee8b2edbaf0336af143f1c75b6f4843e26](https://gitlab.haskell.org/haskell/ghcup-hs/-/commit/c19dd5ee8b2edbaf0336af143f1c75b6f4843e26)
 
 ## Major refactors
 
diff --git a/docs/guide.md b/docs/guide.md
index 98e07d2755715a7aaca781100836c6f7e438e9b6..7bef29c6edbed005fa36e19ddcb9d763a32835b2 100644
--- a/docs/guide.md
+++ b/docs/guide.md
@@ -199,7 +199,7 @@ For the full list of env variables and parameters to tweak the script behavior,
 
 ### Example github workflow
 
-On github workflows you can use https://github.com/haskell/actions/
+On github workflows you can use [https://github.com/haskell/actions/](https://github.com/haskell/actions/)
 
 If you want to install ghcup manually though, here's an example config:
 
diff --git a/docs/install.md b/docs/install.md
index d5bb2991dcc78011e766b53c5efca3ab9ed55c12..50f86fcb0af106fd575a974cddefefd0a46186cf 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -61,8 +61,8 @@ This list may not be exhaustive and specifies support for bindists only.
 
 May or may not work, several issues:
 
-* https://gitlab.haskell.org/haskell/ghcup-hs/-/issues/140
-* https://gitlab.haskell.org/haskell/ghcup-hs/-/issues/197
+* [https://gitlab.haskell.org/haskell/ghcup-hs/-/issues/140](https://gitlab.haskell.org/haskell/ghcup-hs/-/issues/140)
+* [https://gitlab.haskell.org/haskell/ghcup-hs/-/issues/197](https://gitlab.haskell.org/haskell/ghcup-hs/-/issues/197)
 
 ### WSL1