diff --git a/docs/installation.rst b/docs/installation.rst
index 368135c..8c13c82 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -122,7 +122,7 @@ be provided to the containers from the first boot.
 * If you want to support push notifications, set ``TAKAHE_VAPID_PUBLIC_KEY``
   and ``TAKAHE_VAPID_PRIVATE_KEY`` to a valid VAPID keypair (note that if you
   ever change these, push notifications will stop working). You can generate
-  a keypair at `https://web-push-codelab.glitch.me/`_.
+  a keypair at `<https://web-push-codelab.glitch.me/>`_.
 
 There are some other, optional variables you can tweak once the
 system is up and working - see :doc:`tuning` for more.
diff --git a/docs/tuning.rst b/docs/tuning.rst
index e31a04d..5c59678 100644
--- a/docs/tuning.rst
+++ b/docs/tuning.rst
@@ -30,7 +30,7 @@ using more resources if you give them to it), you can:
   has to send a copy of each of their posts to every follower, separately.
 
 * Takahe is run with Gunicorn which spawns several
-  [workers](https://docs.gunicorn.org/en/stable/settings.html#workers) to
+  `workers <https://docs.gunicorn.org/en/stable/settings.html#workers>`_ to
   handle requests. Depending on what environment you are running Takahe on,
   you might want to customize this via the ``GUNICORN_CMD_ARGS`` environment
   variable. For example - ``GUNICORN_CMD_ARGS="--workers 2"`` to set the