diff --git a/docs/pages/release_notes_pmd7.md b/docs/pages/release_notes_pmd7.md
index e57d6c827a..f468452d22 100644
--- a/docs/pages/release_notes_pmd7.md
+++ b/docs/pages/release_notes_pmd7.md
@@ -51,10 +51,10 @@ 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)
 
-{% include note.html content="
+<div class="alert alert-info" role="alert"><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>
 
 ### Revamped Command Line Interface
 
@@ -664,10 +664,10 @@ The rules have been moved into categories with PMD 6.
 
 ## 💥 Compatibility and Migration Notes
 
-{% include note.html content="
+<div class="alert alert-info" role="alert"><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>
 
 ### For endusers
 
diff --git a/docs/render_release_notes.rb b/docs/render_release_notes.rb
index dcd33faca3..e1af48d05b 100755
--- a/docs/render_release_notes.rb
+++ b/docs/render_release_notes.rb
@@ -39,6 +39,10 @@ liquid_env = {
 
 
 to_render = File.read(release_notes_file)
+if to_render.match(/\{%\s*include/)
+    STDERR.printf("\n\n\e[31;1mERROR\e[0m Detected an include tag - this is jekyll specific and not supported here! Please replace it manually\n\n")
+    exit 1
+end
 rendered = Liquid::Template.parse(to_render).render(liquid_env)