diff --git a/kittens/hints/main.py b/kittens/hints/main.py
index a2a18eb3f..e6e4445ab 100644
--- a/kittens/hints/main.py
+++ b/kittens/hints/main.py
@@ -91,7 +91,7 @@ for the operating system. Various special values are supported:
 
 :code:`default`
     run the default open program. Note that when using the hyperlink :code:`--type`
-    the default is to use the kitty :doc:`/open_actions` facilities.
+    the default is to use the kitty :doc:`hyperlink handling </open_actions>` facilities.
 
 :code:`launch`
     run :doc:`/launch` to open the program in a new kitty tab, window, overlay, etc.
diff --git a/tools/cli/markup/prettify.go b/tools/cli/markup/prettify.go
index ab99224f8..51f7f86d9 100644
--- a/tools/cli/markup/prettify.go
+++ b/tools/cli/markup/prettify.go
@@ -140,11 +140,12 @@ func (self *Context) Prettify(text string) string {
 			return self.ref_hyperlink(val, "envvar-")
 		case "doc":
 			text, target := text_and_target(val)
-			if text == target {
-				target = strings.Trim(target, "/")
-				if title, ok := kitty.DocTitleMap[target]; ok {
-					val = title + " <" + target + ">"
-				}
+			no_title := text == target
+			target = strings.Trim(target, "/")
+			if title, ok := kitty.DocTitleMap[target]; ok && no_title {
+				val = title + " <" + target + ">"
+			} else {
+				val = text + " <" + target + ">"
 			}
 			return self.ref_hyperlink(val, "doc-")
 		case "iss":