diff --git a/docs/_config.yml b/docs/_config.yml
index 245707a4e3..002323c571 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -61,6 +61,7 @@ feedback_disable: true
 # if you uncomment the previous line, it changes where the feedback link points to
 
 
+# filter used to process markdown. note that kramdown differs from github-flavored markdown in some subtle ways
 markdown: kramdown
 highlighter: rouge
 kramdown:
@@ -70,8 +71,10 @@ kramdown:
   syntax_highlighter: rouge
   syntax_highlighter_opts:
       css_class: 'highlight'
-  parse_block_html: true
-# filter used to process markdown. note that kramdown differs from github-flavored markdown in some subtle ways
+  parse_block_html: false
+  # selectively enable kramdown parsing for block html elements with attribute 'markdown="block"'
+  # see https://kramdown.gettalong.org/syntax.html
+
 
 collections:
   tooltips:
diff --git a/docs/css/pmd-customstyles.css b/docs/css/pmd-customstyles.css
index de8879dc15..92811b3254 100644
--- a/docs/css/pmd-customstyles.css
+++ b/docs/css/pmd-customstyles.css
@@ -38,6 +38,10 @@ details {
     margin-left: 10px;
 }
 
+details.no-background {
+    background: white;
+}
+
 details p {
     padding: 5px 10px 5px;
     background: white;
diff --git a/docs/pages/pmd/userdocs/3rdpartyrulesets.md b/docs/pages/pmd/userdocs/3rdpartyrulesets.md
index ecbfee2818..92ebd1784b 100644
--- a/docs/pages/pmd/userdocs/3rdpartyrulesets.md
+++ b/docs/pages/pmd/userdocs/3rdpartyrulesets.md
@@ -1,5 +1,7 @@
 ---
 title: 3rd party rulesets
+# language_name is used by shuffle_panel in index.md
+language_name: 3rd party rulesets
 tags: [rule_references, userdocs]
 summary: Lists rulesets and rules from the community
 permalink: pmd_userdocs_3rdpartyrulesets.html
diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md
index bd179eed97..04ce4fbae5 100644
--- a/docs/pages/release_notes.md
+++ b/docs/pages/release_notes.md
@@ -36,7 +36,7 @@ provided feedback and/or PRs!
 A detailed documentation of required changes are available in the [Migration Guide for PMD 7]({{ baseurl }}pmd_userdocs_migrating_to_pmd7.html).
 
 {% if is_release_notes_processor %}
-<details>
+<details markdown="block" class="no-background">
 <summary markdown="span">Expand to see Release Notes
 </summary>
 {% endif %}
@@ -248,7 +248,7 @@ The following previously deprecated rules have been finally removed:
 The following previously deprecated rulesets have been removed. These were the left-over rulesets from PMD 5.
 The rules have been moved into categories with PMD 6.
 
-<details>
+<details markdown="block">
 <summary markdown="span">List of deprecated rulesets
 </summary>
 
@@ -768,8 +768,9 @@ full list of PRs.
 * Days since last release (6.55.0): 377
 * Days since last release (7.0.0-rc4): 160
 
+{% endtocmaker %}
+
 {% if is_release_notes_processor %}
 </details>
 {% endif %}
 
-{% endtocmaker %}
diff --git a/docs/pages/release_notes_pmd7.md b/docs/pages/release_notes_pmd7.md
index 68f0009144..c6a08da166 100644
--- a/docs/pages/release_notes_pmd7.md
+++ b/docs/pages/release_notes_pmd7.md
@@ -51,7 +51,7 @@ Contributors: [Clément Fournier](https://github.com/oowekyala) (@oowekyala),
 [Andreas Dangel](https://github.com/adangel) (@adangel),
 [Juan Martín Sotuyo Dodero](https://github.com/jsotuyod) (@jsotuyod)
 
-<div class="alert alert-info" role="alert"><i class="fas fa-info-circle"></i> <b>Note:</b>
+<div class="alert alert-info" role="alert" markdown="block"><i class="fas fa-info-circle"></i> <b>Note:</b>
 The full detailed documentation of the changes to the Java AST are available in the
 [Migration Guide for PMD 7](pmd_userdocs_migrating_to_pmd7.html#java-ast)
 </div>
@@ -666,7 +666,7 @@ The rules have been moved into categories with PMD 6.
 
 ## 💥 Compatibility and Migration Notes
 
-<div class="alert alert-info" role="alert"><i class="fas fa-info-circle"></i> <b>Note:</b>
+<div class="alert alert-info" role="alert" markdown="block"><i class="fas fa-info-circle"></i> <b>Note:</b>
 The full detailed documentation of the changes are available in the
 [Migration Guide for PMD 7](pmd_userdocs_migrating_to_pmd7.html)
 </div>