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 */>}}
```
+
+
+💡 Make sure to use the `{{* */>}}` shortcode syntax to avoid rendering by Hugo.
+
+
---
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" /%}}
```
+
+
+💡 Make sure to use a closing or self-closing shortcode.
+
+
---
💡 Each data template entry can contain one or more slides, separated by `---` with newlines.