diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc-forward-declaration-namespace.rst b/clang-tools-extra/docs/clang-tidy/checks/misc-forward-declaration-namespace.rst
index c8527b09fcd0..7db873e0edbd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc-forward-declaration-namespace.rst
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc-forward-declaration-namespace.rst
@@ -10,6 +10,7 @@ declaration/definition with the same name existing, which could indicate that
 the forward declaration is in a potentially wrong namespace.
 
 .. code:: c++
+
   namespace na { struct A; }
   namespace nb { struct A {}; }
   nb::A a;
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize-deprecated-headers.rst b/clang-tools-extra/docs/clang-tidy/checks/modernize-deprecated-headers.rst
index 9a06316e332d..4f2b683ffbb3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize-deprecated-headers.rst
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize-deprecated-headers.rst
@@ -1,7 +1,7 @@
 .. title:: clang-tidy - modernize-deprecated-headers
 
 modernize-deprecated-headers
-==========================
+============================
 
 Some headers from C library were deprecated in C++ and are no longer welcome in
 C++ codebases. For more details refer to the C++ 14 Standard [depr.c.headers]