diff --git a/docs/install/add_packages.txt b/docs/install/add-packages.md
similarity index 93%
rename from docs/install/add_packages.txt
rename to docs/install/add-packages.md
index 10f8972..826f65b 100644
--- a/docs/install/add_packages.txt
+++ b/docs/install/add-packages.md
@@ -27,4 +27,4 @@ The packages `gdal` and `there` are now available to all users in JupyterHub.
 If a user already had a python notebook running, they have to restart their notebook's
 kernel to make the new libraries available.
 
-See {ref}`howto-env-user-environment` for more information.
+See [](#howto/user-env/user-environment) for more information.
diff --git a/docs/install/add_users.txt b/docs/install/add-users.md
similarity index 100%
rename from docs/install/add_users.txt
rename to docs/install/add-users.md
diff --git a/docs/install/amazon.md b/docs/install/amazon.md
index 227af91..dd042be 100644
--- a/docs/install/amazon.md
+++ b/docs/install/amazon.md
@@ -268,12 +268,12 @@ Let's create the server on which we can run JupyterHub.
 
 ## Step 2: Adding more users
 
-```{include} add_users.txt
+```{include} add-users.md
 
 ```
 
 ## Step 3: Install conda / pip packages for all users
 
-```{include} add_packages.txt
+```{include} add-packages.md
 
 ```
diff --git a/docs/install/azure.md b/docs/install/azure.md
index 90f9c98..a9f862f 100644
--- a/docs/install/azure.md
+++ b/docs/install/azure.md
@@ -215,12 +215,12 @@ We start by creating the Virtual Machine in which we can run TLJH (The Littlest
 
 ## Step 2: Adding more users
 
-```{include} add_users.txt
+```{include} add-users.md
 
 ```
 
 ## Step 3: Install conda / pip packages for all users
 
-```{include} add_packages.txt
+```{include} add-packages.md
 
 ```
diff --git a/docs/install/custom-server.md b/docs/install/custom-server.md
index 85760a9..8ef92d8 100644
--- a/docs/install/custom-server.md
+++ b/docs/install/custom-server.md
@@ -79,13 +79,13 @@ for custom server installations.
 
 ## Step 2: Adding more users
 
-```{include} add_users.txt
+```{include} add-users.md
 
 ```
 
 ## Step 3: Install conda / pip packages for all users
 
-```{include} add_packages.txt
+```{include} add-packages.md
 
 ```
 
diff --git a/docs/install/digitalocean.md b/docs/install/digitalocean.md
index b6c3411..2f367c6 100644
--- a/docs/install/digitalocean.md
+++ b/docs/install/digitalocean.md
@@ -112,12 +112,12 @@ Let's create the server on which we can run JupyterHub.
 
 ## Step 2: Adding more users
 
-```{include} add_users.txt
+```{include} add-users.md
 
 ```
 
 ## Step 3: Install conda / pip packages for all users
 
-```{include} add_packages.txt
+```{include} add-packages.md
 
 ```
diff --git a/docs/install/google.md b/docs/install/google.md
index 8fd73d6..e6d125e 100644
--- a/docs/install/google.md
+++ b/docs/install/google.md
@@ -208,12 +208,12 @@ Let's create the server on which we can run JupyterHub.
 
 ## Step 2: Adding more users
 
-```{include} add_users.txt
+```{include} add-users.md
 
 ```
 
 ## Step 3: Install conda / pip packages for all users
 
-```{include} add_packages.txt
+```{include} add-packages.md
 
 ```
diff --git a/docs/install/jetstream.md b/docs/install/jetstream.md
index 7205cf8..b068ca1 100644
--- a/docs/install/jetstream.md
+++ b/docs/install/jetstream.md
@@ -141,12 +141,12 @@ Let's create the server on which we can run JupyterHub.
 
 ## Step 2: Adding more users
 
-```{include} add_users.txt
+```{include} add-users.md
 
 ```
 
 ## Step 3: Install conda / pip packages for all users
 
-```{include} add_packages.txt
+```{include} add-packages.md
 
 ```
diff --git a/docs/install/ovh.md b/docs/install/ovh.md
index 2a562f6..eec287e 100644
--- a/docs/install/ovh.md
+++ b/docs/install/ovh.md
@@ -122,12 +122,12 @@ Let's create the server on which we can run JupyterHub.
 
 ## Step 2: Adding more users
 
-```{include} add_users.txt
+```{include} add-users.md
 
 ```
 
 ## Step 3: Install conda / pip packages for all users
 
-```{include} add_packages.txt
+```{include} add-packages.md
 
 ```