diff --git a/exampleSite/content/home/shortcodes/markdown.md b/exampleSite/content/home/shortcodes/markdown.md
index 65ff013..21167bd 100644
--- a/exampleSite/content/home/shortcodes/markdown.md
+++ b/exampleSite/content/home/shortcodes/markdown.md
@@ -16,6 +16,11 @@ Reveal.js has its own [markdown processor](https://github.com/hakimel/reveal.js#
 {{</* /markdown */>}}
 ```
 
+<br>
+<small>
+💡 Make sure to use the `{{</* */>}}` shortcode syntax to avoid rendering by Hugo.
+</small>
+
 ---
 
 <!-- .slide: data-background="#FF4081" -->
diff --git a/exampleSite/content/home/shortcodes/slide.md b/exampleSite/content/home/shortcodes/slide.md
index 3b3694f..dc63834 100644
--- a/exampleSite/content/home/shortcodes/slide.md
+++ b/exampleSite/content/home/shortcodes/slide.md
@@ -44,6 +44,6 @@ Customize individual slide parameters like background color and transition.
 
 {{% section %}}
 
-{{< slide content="home.example" >}}
+{{% slide content="home.example" /%}}
 
 {{% /section %}}
diff --git a/exampleSite/data/home.toml b/exampleSite/data/home.toml
index 1c6dd8f..e7d3696 100644
--- a/exampleSite/data/home.toml
+++ b/exampleSite/data/home.toml
@@ -23,9 +23,14 @@ example = "I'm a slide"
 Set the `content` attribute to "home.example":
 
 ```
-{{< slide content="home.example" >}}
+{{% slide content="home.example" /%}}
 ```
 
+<br>
+<small>
+💡 Make sure to use a closing or self-closing shortcode.
+</small>
+
 ---
 
 💡 Each data template entry can contain one or more slides, separated by `---` with newlines.