diff --git a/clippy.toml b/clippy.toml
new file mode 100644
index 00000000..08717a45
--- /dev/null
+++ b/clippy.toml
@@ -0,0 +1 @@
+doc-valid-idents = ["CoreText", "DirectWrite", "FreeType", "HarfBuzz", "OpenType", ".."]
diff --git a/harfbuzz-sys/src/lib.rs b/harfbuzz-sys/src/lib.rs
index 21dec8df..69b070f9 100644
--- a/harfbuzz-sys/src/lib.rs
+++ b/harfbuzz-sys/src/lib.rs
@@ -21,6 +21,7 @@
 //! - `bundled` - Use the bundled copy of the harfbuzz library rather than one installed on the system.
 
 #![no_std]
+#![warn(clippy::doc_markdown)]
 
 #[cfg(all(target_vendor = "apple", feature = "coretext"))]
 pub mod coretext;
diff --git a/harfbuzz/src/lib.rs b/harfbuzz/src/lib.rs
index fa1f4228..e86fa63a 100644
--- a/harfbuzz/src/lib.rs
+++ b/harfbuzz/src/lib.rs
@@ -20,7 +20,7 @@
 //! - `bundled` - Use the bundled copy of the harfbuzz library rather than one installed on the system.
 
 #![no_std]
-#![warn(missing_docs)]
+#![warn(clippy::doc_markdown, missing_docs)]
 #![deny(
     trivial_numeric_casts,
     unstable_features,