diff --git a/clippy_lints/src/methods/mod.rs b/clippy_lints/src/methods/mod.rs
index 7f4964da72e7..98d9426bd8a5 100644
--- a/clippy_lints/src/methods/mod.rs
+++ b/clippy_lints/src/methods/mod.rs
@@ -339,13 +339,16 @@ declare_clippy_lint! {
     /// **Known problems:** None.
     ///
     /// **Example:**
+    ///
+    /// Bad:
     /// ```rust
-    /// # Bad
-    /// let r: Result<u32, &str> = Ok(1);
+    /// # let r: Result<u32, &str> = Ok(1);
     /// assert_eq!(Some(1), r.map_or(None, Some));
+    /// ```
     ///
-    /// # Good
-    /// let r: Result<u32, &str> = Ok(1);
+    /// Good:
+    /// ```rust
+    /// # let r: Result<u32, &str> = Ok(1);
     /// assert_eq!(Some(1), r.ok());
     /// ```
     pub RESULT_MAP_OR_INTO_OPTION,