diff --git a/pubspec.yaml b/pubspec.yaml
index 734cdfd72..ba310f719 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -42,7 +42,7 @@ dev_dependencies:
   archive: ^3.1.2
   crypto: ^3.0.0
   dart_style: ^2.0.0
-  dartdoc: ^8.0.14
+  dartdoc: ">=8.0.14 <8.3.1" # dart-lang/dartdoc#3947
   grinder: ^0.9.0
   node_preamble: ^2.0.2
   lints: ">=4.0.0 <6.0.0"