diff --git a/nixos/modules/programs/chromium.nix b/nixos/modules/programs/chromium.nix
index 98eb071e6144..5e2e0b5741b6 100644
--- a/nixos/modules/programs/chromium.nix
+++ b/nixos/modules/programs/chromium.nix
@@ -79,7 +79,7 @@ in
         description = ''
           Extra chromium policy options. A list of available policies
           can be found in the Chrome Enterprise documentation:
-          <link xlink:href="https://cloud.google.com/docs/chrome-enterprise/policies/">https://cloud.google.com/docs/chrome-enterprise/policies/</link>
+          <link xlink:href="https://cloud.google.com/docs/chrome-enterprise/policies/"/>
           Make sure the selected policy is supported on Linux and your browser version.
         '';
         default = {};
diff --git a/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix b/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix
index 9e1fb0307576..7437242043ea 100644
--- a/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix
+++ b/nixos/modules/services/continuous-integration/hercules-ci-agent/common.nix
@@ -107,7 +107,7 @@ let
           Location of the cluster-join-token.key file.
 
           You can retrieve the contents of the file when creating a new agent via
-          <link xlink:href="https://hercules-ci.com/dashboard">https://hercules-ci.com/dashboard</link>.
+          <link xlink:href="https://hercules-ci.com/dashboard"/>.
 
           As this value is confidential, it should not be in the store, but
           installed using other means, such as agenix, NixOps
@@ -127,7 +127,7 @@ let
           copied over using other means, such as agenix, NixOps
           <literal>deployment.keys</literal>, or manual installation.
 
-          The format is described on <link xlink:href="https://docs.hercules-ci.com/hercules-ci-agent/binary-caches-json/">https://docs.hercules-ci.com/hercules-ci-agent/binary-caches-json/</link>.
+          The format is described on <link xlink:href="https://docs.hercules-ci.com/hercules-ci-agent/binary-caches-json/"/>.
         '';
         type = types.path;
         default = config.staticSecretsDirectory + "/binary-caches.json";
@@ -141,8 +141,7 @@ let
           copied over using other means, such as agenix, NixOps
           <literal>deployment.keys</literal>, or manual installation.
 
-          The format is described on <link xlink:href="https://docs.hercules-ci.com/hercules-ci-agent/secrets-json/">https://docs.hercules-ci.com/hercules-ci-agent/secrets-json/</link>.
-
+          The format is described on <link xlink:href="https://docs.hercules-ci.com/hercules-ci-agent/secrets-json/"/>.
         '';
         type = types.path;
         default = config.staticSecretsDirectory + "/secrets.json";