diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst
index 60c783655b9d..69a6f1255167 100644
--- a/Doc/documenting/markup.rst
+++ b/Doc/documenting/markup.rst
@@ -610,6 +610,8 @@ Example::
 
 The ``:ref:`` invocation is replaced with the section title.
 
+Alternatively, you can reference any label (not just section titles)
+if you provide the link text ``:ref:`link text`<reference-label>```.
 
 Paragraph-level markup
 ----------------------