diff --git a/doc/usage/restructuredtext/basics.rst b/doc/usage/restructuredtext/basics.rst
index ea61b80fc85..67992b7f0ac 100644
--- a/doc/usage/restructuredtext/basics.rst
+++ b/doc/usage/restructuredtext/basics.rst
@@ -249,6 +249,12 @@ You can also separate the link and the target definition (:duref:`ref
 
    .. _a link: https://domain.invalid/
 
+If you want to set a custom target name::
+
+    This paragraph contains `a link with a custom target name <custom_>`_.
+
+    .. _custom: https://domain.invalid/
+
 Internal links
 ~~~~~~~~~~~~~~