diff --git a/format.h b/format.h
index a25d807c..30c53849 100644
--- a/format.h
+++ b/format.h
@@ -60,6 +60,10 @@
 # define FMT_GCC_EXTENSION
 #endif
 
+#ifdef __clang__
+# pragma clang diagnostic ignored "-Wdocumentation-unknown-command"
+#endif
+
 #ifdef __GNUC_LIBSTD__
 # define FMT_GNUC_LIBSTD_VERSION (__GNUC_LIBSTD__ * 100 + __GNUC_LIBSTD_MINOR__)
 #endif
@@ -2469,6 +2473,10 @@ FMT_VARIADIC(int, fprintf, std::FILE *, StringRef)
 # pragma GCC diagnostic pop
 #endif
 
+#ifdef __clang__
+# pragma clang diagnostic pop
+#endif
+
 #ifdef FMT_HEADER_ONLY
 # include "format.cc"
 #endif