diff --git a/modules/programs/vim.nix b/modules/programs/vim.nix
index e246c21fd..b96adeacb 100644
--- a/modules/programs/vim.nix
+++ b/modules/programs/vim.nix
@@ -32,8 +32,8 @@ in
         default = defaultPlugins;
         example = [ "YankRing" ];
         description = ''
-          List of vim plugins to install.
-          For supported plugins see: https://github.com/NixOS/nixpkgs/blob/master/pkgs/misc/vim-plugins/vim-plugin-names
+          List of vim plugins to install. For supported plugins see:
+          <link xlink:href="https://github.com/NixOS/nixpkgs/blob/master/pkgs/misc/vim-plugins/vim-plugin-names"/>.
         '';
       };
 
diff --git a/modules/programs/zsh.nix b/modules/programs/zsh.nix
index dd0f986ab..c7ad77023 100644
--- a/modules/programs/zsh.nix
+++ b/modules/programs/zsh.nix
@@ -105,8 +105,9 @@ let
         type = types.str;
         example = "$HOME/my_customizations";
         description = ''
-          Path to a custom oh-my-zsh package to override config of oh-my-zsh.
-          See: https://github.com/robbyrussell/oh-my-zsh/wiki/Customization
+          Path to a custom oh-my-zsh package to override config of
+          oh-my-zsh. See <link xlink:href="https://github.com/robbyrussell/oh-my-zsh/wiki/Customization"/>
+          for more information.
         '';
       };