diff --git a/ruma-identity-service-api/src/tos/accept_terms_of_service/v2.rs b/ruma-identity-service-api/src/tos/accept_terms_of_service/v2.rs
index 08c250eb..71b67af2 100644
--- a/ruma-identity-service-api/src/tos/accept_terms_of_service/v2.rs
+++ b/ruma-identity-service-api/src/tos/accept_terms_of_service/v2.rs
@@ -15,7 +15,7 @@ ruma_api! {
     request: {
         /// The URLs the user is accepting in this request.
         ///
-        /// An example is "https://example.org/somewhere/terms-2.0-en.html".
+        /// An example is `https://example.org/somewhere/terms-2.0-en.html`.
         pub user_accepts: Vec<String>,
     }
 
diff --git a/ruma-identity-service-api/src/tos/get_terms_of_service/v2.rs b/ruma-identity-service-api/src/tos/get_terms_of_service/v2.rs
index 988abaea..2f1cbe4b 100644
--- a/ruma-identity-service-api/src/tos/get_terms_of_service/v2.rs
+++ b/ruma-identity-service-api/src/tos/get_terms_of_service/v2.rs
@@ -67,7 +67,7 @@ pub struct LocalizedPolicy {
 
     /// The URL at wich the policy is available.
     ///
-    /// Examples are "https://example.org/somewhere/terms-2.0-en.html"
-    /// and "https://example.org/somewhere/terms-2.0-fr.html".
+    /// Examples are `https://example.org/somewhere/terms-2.0-en.html`
+    /// and `https://example.org/somewhere/terms-2.0-fr.html`.
     pub url: String,
 }