diff --git a/documentation/docs/dev/troubleshooting.md b/documentation/docs/dev/troubleshooting.md
index 3e036e232d92e3b3db802cfffff68d1b565e4ed9..52944f2449685d86c89bed977bb8ad03bfb7449c 100644
--- a/documentation/docs/dev/troubleshooting.md
+++ b/documentation/docs/dev/troubleshooting.md
@@ -32,16 +32,17 @@ Fatal Application Error. Can't setup a valid OpenGL canvas, something is serious
 
 Then, your local machine probably has the **indirect rendering of OpenGL** content **disabled**.
 
-In the case of macOS, Apple has disabled the remote indirect rendering of OpenGL by default for a few years, so running remote OpenGL applications (any OpenGL applications) does not work out of the box.
+In the case of **macOS**, Apple has disabled the remote indirect rendering of OpenGL by default for a few years, so running remote OpenGL applications (any OpenGL applications) does not work out of the box.
 
 **Re-enabling the indirect rendering solves the problem. **
 
 You can see a few instructions on the VP1 pages here:
-https://atlas-vp1.web.cern.ch/atlas-vp1/home/documentation/how-to-run-vp1/tutorial/0-pre-requisites/#Mac_OS_X
 
-You get a similar situation if you run from a recent Fedora or an Alma9 machine. In that case, you can find instructions here: 
+<https://atlas-vp1.web.cern.ch/atlas-vp1/home/documentation/how-to-run-vp1/tutorial/0-pre-requisites/#Mac_OS_X>
 
-https://askubuntu.com/questions/1100451/how-to-enable-allowindirectglx-on-ubuntu-18-04-with-nvidia-1050ti 
+You get a similar situation if you run from a recent **Fedora** or an **Alma9** machine. In that case, you can find instructions here: 
+
+<https://askubuntu.com/questions/1100451/how-to-enable-allowindirectglx-on-ubuntu-18-04-with-nvidia-1050ti>