diff --git a/gtk/deprecated/gtkuimanager.c b/gtk/deprecated/gtkuimanager.c
index 429ff350f2..7400213880 100644
--- a/gtk/deprecated/gtkuimanager.c
+++ b/gtk/deprecated/gtkuimanager.c
@@ -121,7 +121,7 @@
  * enclosed in doublequotes, thus they must not '"' characters or references
  * to the " entity.
  *
- * ## A UI definition ##
+ * # A UI definition #
  *
  * |[
  * <ui>
diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index 4a85e9f72c..8d77ed9a0e 100644
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -56,7 +56,7 @@
  * The function gtk_builder_connect_signals() and variants thereof can be
  * used to connect handlers to the named signals in the description.
  *
- * # GtkBuilder UI Definitions
+ * # GtkBuilder UI Definitions # {#BUILDER-UI}
  *
  * GtkBuilder parses textual descriptions of user interfaces which are
  * specified in an XML format which can be roughly described by the