diff --git a/docs/software/ssh_key_use_bianca.md b/docs/software/ssh_key_use_bianca.md
index 7a9fa5355..01d39a94c 100644
--- a/docs/software/ssh_key_use_bianca.md
+++ b/docs/software/ssh_key_use_bianca.md
@@ -113,7 +113,7 @@ Save the file and close `nano`.
 
 On Bianca, do:
 
-```
+```bash
 chmod 700 .ssh/authorized_keys
 chmod 700 .ssh
 chmod 700 ~
diff --git a/docs/software/vscode_on_rackham.md b/docs/software/vscode_on_rackham.md
index 9e29cd5ff..24ff3768f 100644
--- a/docs/software/vscode_on_rackham.md
+++ b/docs/software/vscode_on_rackham.md
@@ -85,7 +85,7 @@ In the bottom left of VSCode, click on the popup window 'Connect'.
 
 ???- question "How does that look like?"
 
-![](./img/vscode_on_rackham_new_remote_click_connect.png)
+![Click on 'Connect'](./img/vscode_on_rackham_new_remote_click_connect.png)
 
 ### 8. Done
 
@@ -110,7 +110,7 @@ You are now connected: there is a new window with VSCode connected to Rackham.
 
 ### 1. Connect your local VSCode to VSCode server running on Rackham
 
-Perform steps mentioned under the section [Procedure to start VSCode](#procedure-to-start-vscode).  
+Perform steps mentioned under the section [Procedure to start VSCode](#procedure).
 
 When you first establish the ssh connection to Rackham, your VSCode server directory `.vscode-server` will be created in your home folder `/home/[username]`.