diff --git a/doc/development/documentation/styleguide.md b/doc/development/documentation/styleguide.md
index b10136a6ffe6ce54f528307c4869a8c0e091187b..9fd5f6548dd51e27eecddd17f38c70968c533b4e 100644
--- a/doc/development/documentation/styleguide.md
+++ b/doc/development/documentation/styleguide.md
@@ -1140,8 +1140,8 @@ The following are examples of source Markdown for menu items with their publishe
 Whenever you need to call special attention to particular sentences,
 use the following markup for highlighting.
 
-_Note that the alert boxes only work for one paragraph only. Multiple paragraphs,
-lists, headers and so on, will not render correctly. For multiple lines, use blockquotes instead._
+Note that the alert boxes only work for one paragraph only. Multiple paragraphs,
+lists, headers and so on, will not render correctly. For multiple lines, use [blockquotes](#blockquotes) instead.
 
 Alert boxes only render on the GitLab Docs site (<https://docs.gitlab.com>).
 Within GitLab itself, they will appear as plain Markdown text (like the examples