diff --git a/swh/web/api/apidoc.py b/swh/web/api/apidoc.py
--- a/swh/web/api/apidoc.py
+++ b/swh/web/api/apidoc.py
@@ -94,7 +94,7 @@
         subs_made = 1
         while subs_made:
             (par, subs_made) = re.subn(r"(:http:.*)(\[.*\])", r"\1", par)
-        par = par.replace("//", "/")
+        par = re.sub(r"([^:])//", r"\1/", par)
         # transform references to api endpoints doc into valid rst links
         par = re.sub(":http:get:`([^,`]*)`", r"`\1 <\1doc/>`_", par)
         # transform references to some elements into bold text
diff --git a/swh/web/tests/api/test_apidoc.py b/swh/web/tests/api/test_apidoc.py
--- a/swh/web/tests/api/test_apidoc.py
+++ b/swh/web/tests/api/test_apidoc.py
@@ -482,7 +482,7 @@
     third_link = textwrap.indent(
         (
             '<a class="reference external" '
-            'href="https:/archive.softwareheritage.org">\n'
+            'href="https://archive.softwareheritage.org">\n'
             " archive\n"
             "</a>"
         ),