diff --git a/kitty/conf/types.py b/kitty/conf/types.py
index 482e84aa6..1c4d8c3bc 100644
--- a/kitty/conf/types.py
+++ b/kitty/conf/types.py
@@ -44,8 +44,9 @@ def expand_opt_references(conf_name: str, text: str) -> str:
 def remove_markup(text: str) -> str:
     ref_map = {
         'layouts': f'{website_url("overview")}#layouts',
-        'sessions': f'{website_url("overview")}#layouts',
+        'sessions': f'{website_url("overview")}#startup-sessions',
         'functional': f'{website_url("keyboard-protocol")}#functional-key-definitions',
+        'action-select_tab': f'{website_url("actions")}#select-tab',
     }
 
     def sub(m: Match) -> str:
diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index bb0bdcd34..66e29e70a 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -879,8 +879,8 @@ The tab bar style, can be one of: :code:`fade`, :code:`separator`,
 into the background color, in the separator style, tabs are separated by a
 configurable separator, and the powerline shows the tabs as a continuous line.
 If you use the hidden style, you might want to create a mapping for the
-:code:`select_tab` action which presents you with a list of tabs and allows for
-easy switching to a tab.
+:ref:`action-select_tab` action which presents you with a list of tabs
+and allows for easy switching to a tab.
 '''
     )