diff --git a/gdk/gdkapplaunchcontext.c b/gdk/gdkapplaunchcontext.c
index e91cb05bf3..22e517790c 100644
--- a/gdk/gdkapplaunchcontext.c
+++ b/gdk/gdkapplaunchcontext.c
@@ -236,8 +236,7 @@ gdk_app_launch_context_set_screen (GdkAppLaunchContext *context,
  * Sets the workspace on which applications will be launched when
  * using this context when running under a window manager that
  * supports multiple workspaces, as described in the
- * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink>.
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec).
  *
  * When the workspace is not specified or @desktop is set to -1,
  * it is up to the window manager to pick one, typically it will
diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index ca2c396641..1bce6cac76 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -1644,8 +1644,7 @@ gdk_display_supports_clipboard_persistence (GdkDisplay *display)
  * Issues a request to the clipboard manager to store the
  * clipboard data. On X11, this is a special program that works
  * according to the freedesktop clipboard specification, available at
- * <ulink url="http://www.freedesktop.org/Standards/clipboard-manager-spec">
- * http://www.freedesktop.org/Standards/clipboard-manager-spec</ulink>.
+ * [http://www.freedesktop.org/Standards/clipboard-manager-spec](http://www.freedesktop.org/Standards/clipboard-manager-spec).
  *
  * Since: 2.6
  */
diff --git a/gdk/gdkscreen.c b/gdk/gdkscreen.c
index 113d2a4052..b25a5ca5d4 100644
--- a/gdk/gdkscreen.c
+++ b/gdk/gdkscreen.c
@@ -992,9 +992,9 @@ gdk_screen_make_display_name (GdkScreen *screen)
  * Returns the screen's currently active window.
  *
  * On X11, this is done by inspecting the _NET_ACTIVE_WINDOW property
- * on the root window, as described in the <ulink
- * url="http://www.freedesktop.org/Standards/wm-spec">Extended Window
- * Manager Hints</ulink>. If there is no currently currently active
+ * on the root window, as described in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec).
+ * If there is no currently currently active
  * window, or the window manager does not support the
  * _NET_ACTIVE_WINDOW hint, this function returns %NULL.
  *
@@ -1024,9 +1024,9 @@ gdk_screen_get_active_window (GdkScreen *screen)
  * window stack.
  *
  * On X11, this is done by inspecting the _NET_CLIENT_LIST_STACKING
- * property on the root window, as described in the <ulink
- * url="http://www.freedesktop.org/Standards/wm-spec">Extended Window
- * Manager Hints</ulink>. If the window manager does not support the
+ * property on the root window, as described in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec).
+ * If the window manager does not support the
  * _NET_CLIENT_LIST_STACKING hint, this function returns %NULL.
  *
  * On other platforms, this function may return %NULL, depending on whether
diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index 5a84ccc6bb..68aceae762 100644
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -10208,8 +10208,9 @@ gdk_window_set_functions (GdkWindow    *window,
  * Begins a window resize operation (for a toplevel window).
  * You might use this function to implement a "window resize grip," for
  * example; in fact #GtkStatusbar uses it. The function works best
- * with window managers that support the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended Window Manager Hints</ulink>, but has a
- * fallback implementation for other window managers.
+ * with window managers that support the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * but has a fallback implementation for other window managers.
  *
  * Since: 3.4
  */
@@ -10268,10 +10269,9 @@ gdk_window_begin_resize_drag (GdkWindow     *window,
  *
  * Begins a window move operation (for a toplevel window).
  * You might use this function to implement a "window move grip," for
- * example. The function works best with window managers that support
- * the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink>, but has a fallback implementation for
- * other window managers.
+ * example. The function works best with window managers that support the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * but has a fallback implementation for other window managers.
  *
  * Since: 3.4
  */
diff --git a/gdk/gdkwindow.h b/gdk/gdkwindow.h
index 268dba528f..41f04a2814 100644
--- a/gdk/gdkwindow.h
+++ b/gdk/gdkwindow.h
@@ -177,10 +177,8 @@ typedef enum
  * the window has. The window manager can use this when determining decoration
  * and behaviour of the window. The hint must be set before mapping the window.
  *
- * See the
- * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink> specification for more details about
- * window types.
+ * See the [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * specification for more details about window types.
  */
 typedef enum
 {
@@ -274,8 +272,8 @@ typedef enum
  * Defines the reference point of a window and the meaning of coordinates
  * passed to gtk_window_move(). See gtk_window_move() and the "implementation
  * notes" section of the
- * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink> specification for more details.
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * specification for more details.
  */
 typedef enum
 {
diff --git a/gdk/wayland/gdkdisplay-wayland.c b/gdk/wayland/gdkdisplay-wayland.c
index 64224b16ec..03044657eb 100644
--- a/gdk/wayland/gdkdisplay-wayland.c
+++ b/gdk/wayland/gdkdisplay-wayland.c
@@ -443,10 +443,9 @@ gdk_wayland_display_get_next_serial (GdkDisplay *display)
  *
  * This is a convenience function for use by code that implements the
  * freedesktop startup notification specification. Applications should
- * not normally need to call it directly. See the <ulink
- * url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup
- * Notification Protocol specification</ulink> for
- * definitions of the message types and keys that can be used.
+ * not normally need to call it directly. See the 
+ * [Startup Notification Protocol specification](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt)
+ * for definitions of the message types and keys that can be used.
  *
  * Since: 2.12
  **/
diff --git a/gdk/x11/gdkdisplay-x11.c b/gdk/x11/gdkdisplay-x11.c
index 34e84af1bf..fc6039cf4b 100644
--- a/gdk/x11/gdkdisplay-x11.c
+++ b/gdk/x11/gdkdisplay-x11.c
@@ -2147,10 +2147,9 @@ broadcast_xmessage (GdkDisplay *display,
  *
  * This is a convenience function for use by code that implements the
  * freedesktop startup notification specification. Applications should
- * not normally need to call it directly. See the <ulink
- * url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup
- * Notification Protocol specification</ulink> for
- * definitions of the message types and keys that can be used.
+ * not normally need to call it directly. See the
+ * [Startup Notification Protocol specification](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt)
+ * for definitions of the message types and keys that can be used.
  *
  * Since: 2.12
  **/
diff --git a/gdk/x11/gdkscreen-x11.c b/gdk/x11/gdkscreen-x11.c
index feda7b25fe..3e5b9ad722 100644
--- a/gdk/x11/gdkscreen-x11.c
+++ b/gdk/x11/gdkscreen-x11.c
@@ -1543,9 +1543,7 @@ fetch_net_wm_check_window (GdkScreen *screen)
  *
  * This function is specific to the X11 backend of GDK, and indicates
  * whether the window manager supports a certain hint from the
- * Extended Window Manager Hints Specification. You can find this
- * specification on
- * <ulink url="http://www.freedesktop.org">http://www.freedesktop.org</ulink>.
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
  *
  * When using this function, keep in mind that the window manager
  * can change over time; so you shouldn't use this function in
@@ -1793,8 +1791,8 @@ get_netwm_cardinal_property (GdkScreen   *screen,
  *
  * Returns the number of workspaces for @screen when running under a
  * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.
+ * in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
  *
  * Returns: the number of workspaces, or 0 if workspaces are not supported
  *
@@ -1812,8 +1810,8 @@ gdk_x11_screen_get_number_of_desktops (GdkScreen *screen)
  *
  * Returns the current workspace for @screen when running under a
  * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.
+ * in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
  *
  * Returns: the current workspace, or 0 if workspaces are not supported
  *
diff --git a/gdk/x11/gdkwindow-x11.c b/gdk/x11/gdkwindow-x11.c
index 3f213aa11c..788b57eac9 100644
--- a/gdk/x11/gdkwindow-x11.c
+++ b/gdk/x11/gdkwindow-x11.c
@@ -2103,9 +2103,8 @@ gdk_window_x11_lower (GdkWindow *window)
  * 
  * Moves the window to the correct workspace when running under a 
  * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.  Will not do anything if the
- * window is already on all workspaces.
+ * in the [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
+ * Will not do anything if the window is already on all workspaces.
  * 
  * Since: 2.8
  */
@@ -2193,8 +2192,7 @@ gdk_x11_window_get_desktop (GdkWindow *window)
  *
  * Moves the window to the given workspace when running unde a
  * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.
+ * in the [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
  *
  * Since: 3.10
  */