diff --git a/Cargo.toml b/Cargo.toml
index 6e1bafd1dd..78725d2084 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -31,6 +31,7 @@ members = [
 
 [workspace.lints.clippy]
 type_complexity = "allow"
+doc_markdown = "warn"
 
 [lints]
 workspace = true
diff --git a/tools/ci/src/main.rs b/tools/ci/src/main.rs
index ebb12c2786..239cefd3f6 100644
--- a/tools/ci/src/main.rs
+++ b/tools/ci/src/main.rs
@@ -17,8 +17,7 @@ bitflags! {
     }
 }
 
-const CLIPPY_FLAGS: [&str; 6] = [
-    "-Wclippy::doc_markdown",
+const CLIPPY_FLAGS: [&str; 5] = [
     "-Wclippy::redundant_else",
     "-Wclippy::match_same_arms",
     "-Wclippy::semicolon_if_nothing_returned",