diff --git a/ext/theora/gsttheoradec.c b/ext/theora/gsttheoradec.c
index a506d2bd73..862aa16988 100644
--- a/ext/theora/gsttheoradec.c
+++ b/ext/theora/gsttheoradec.c
@@ -26,9 +26,9 @@
  * @see_also: theoraenc, oggdemux
  *
  * This element decodes theora streams into raw video
- * <ulink url="http://www.theora.org/">Theora</ulink> is a royalty-free
- * video codec maintained by the <ulink url="http://www.xiph.org/">Xiph.org
- * Foundation</ulink>, based on the VP3 codec.
+ * [Theora](http://www.theora.org/) is a royalty-free
+ * video codec maintained by the [Xiph.org Foundation](http://www.xiph.org/),
+ * based on the VP3 codec.
  *
  * ## Example pipeline
  * |[
diff --git a/ext/theora/gsttheoraenc.c b/ext/theora/gsttheoraenc.c
index 90118fbd0e..6bbcc48341 100644
--- a/ext/theora/gsttheoraenc.c
+++ b/ext/theora/gsttheoraenc.c
@@ -26,9 +26,9 @@
  * @see_also: theoradec, oggmux
  *
  * This element encodes raw video into a Theora stream.
- * <ulink url="http://www.theora.org/">Theora</ulink> is a royalty-free
- * video codec maintained by the <ulink url="http://www.xiph.org/">Xiph.org
- * Foundation</ulink>, based on the VP3 codec.
+ * [Theora](http://www.theora.org/) is a royalty-free
+ * video codec maintained by the [Xiph.org Foundation](http://www.xiph.org/),
+ * based on the VP3 codec.
  *
  * The theora codec internally only supports encoding of images that are a
  * multiple of 16 pixels in both X and Y direction. It is however perfectly
diff --git a/ext/vorbis/gstvorbisdec.c b/ext/vorbis/gstvorbisdec.c
index a0b48b71b9..cd44d1d508 100644
--- a/ext/vorbis/gstvorbisdec.c
+++ b/ext/vorbis/gstvorbisdec.c
@@ -23,10 +23,9 @@
  * @see_also: vorbisenc, oggdemux
  *
  * This element decodes a Vorbis stream to raw float audio.
- * <ulink url="http://www.vorbis.com/">Vorbis</ulink> is a royalty-free
- * audio codec maintained by the <ulink url="http://www.xiph.org/">Xiph.org
- * Foundation</ulink>. As it outputs raw float audio you will often need to
- * put an audioconvert element after it.
+ * [Vorbis](http://www.vorbis.com/) is a royalty-free audio codec maintained
+ * by the [Xiph.org Foundation](http://www.xiph.org/). As it outputs raw float
+ * audio you will often need to put an audioconvert element after it.
  *
  * ## Example pipelines
  * |[
diff --git a/ext/vorbis/gstvorbisenc.c b/ext/vorbis/gstvorbisenc.c
index 681d75eb98..1c0b2c2e2c 100644
--- a/ext/vorbis/gstvorbisenc.c
+++ b/ext/vorbis/gstvorbisenc.c
@@ -23,9 +23,8 @@
  * @see_also: vorbisdec, oggmux
  *
  * This element encodes raw float audio into a Vorbis stream.
- * <ulink url="http://www.vorbis.com/">Vorbis</ulink> is a royalty-free
- * audio codec maintained by the <ulink url="http://www.xiph.org/">Xiph.org
- * Foundation</ulink>.
+ * [Vorbis](http://www.vorbis.com/) is a royalty-free audio codec maintained by
+ * the [Xiph.org Foundation](http://www.xiph.org/).
  *
  * ## Example pipelines
  * |[