diff --git a/ruma-api/src/lib.rs b/ruma-api/src/lib.rs
index 44c7e1ef..6ba508db 100644
--- a/ruma-api/src/lib.rs
+++ b/ruma-api/src/lib.rs
@@ -195,9 +195,9 @@ use http::Method;
 ///
 /// ## Fallible deserialization
 ///
-/// All request and response types also derive [`Outgoing`][Outgoing]. As such, to allow
-/// fallible deserialization, you can use the `#[wrap_incoming]` attribute. For details, see
-/// the documentation for [the derive macro](derive.Outgoing.html).
+/// All request and response types also derive [`Outgoing`][trait@ruma_serde::Outgoing]. As such,
+/// to allow fallible deserialization, you can use the `#[wrap_incoming]` attribute. For details,
+/// see the documentation for [the derive macro](derive@ruma_serde::Outgoing).
 // TODO: Explain the concept of fallible deserialization before jumping to
 // `ruma_serde::Outgoing`
 pub use ruma_api_macros::ruma_api;
diff --git a/ruma-client-api/src/r0/media/get_content.rs b/ruma-client-api/src/r0/media/get_content.rs
index 9dd84645..0569a0f1 100644
--- a/ruma-client-api/src/r0/media/get_content.rs
+++ b/ruma-client-api/src/r0/media/get_content.rs
@@ -44,7 +44,7 @@ ruma_api! {
         ///
         /// See [MDN] for the syntax.
         ///
-        /// https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition#Syntax
+        /// [MDN]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition#Syntax
         #[ruma_api(header = CONTENT_DISPOSITION)]
         pub content_disposition: Option<String>,
     }
diff --git a/ruma-client-api/src/r0/media/get_content_as_filename.rs b/ruma-client-api/src/r0/media/get_content_as_filename.rs
index 854f2344..d58f8e6b 100644
--- a/ruma-client-api/src/r0/media/get_content_as_filename.rs
+++ b/ruma-client-api/src/r0/media/get_content_as_filename.rs
@@ -49,7 +49,7 @@ ruma_api! {
         ///
         /// See [MDN] for the syntax.
         ///
-        /// https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition#Syntax
+        /// [MDN]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition#Syntax
         #[ruma_api(header = CONTENT_DISPOSITION)]
         pub content_disposition: Option<String>,
     }