diff --git a/templates/shortcodes/embed_video.html b/templates/shortcodes/embed_video.html
index bdd1fa41d..c9590466e 100644
--- a/templates/shortcodes/embed_video.html
+++ b/templates/shortcodes/embed_video.html
@@ -1,9 +1,9 @@
-<!-- {#
+{# <!--
 Embed a video into a markdown file. Example usage:
 
     {{ embed_video(type="video/mp4", src="my-video.mp4", caption="Some caption.") }}
 
-#} -->
+--> #}
 <figure>
     <video controls autoplay muted loop>
         <source type="{{ type }}" src="{{ get_url(path=page.colocated_path ~ src)}}" />
diff --git a/templates/shortcodes/image_figure.html b/templates/shortcodes/image_figure.html
index e45c063a8..1e8b69b1c 100644
--- a/templates/shortcodes/image_figure.html
+++ b/templates/shortcodes/image_figure.html
@@ -1,4 +1,4 @@
-<!-- {#
+{# <!--
     Displays an image with a legend.
 
     Example usage:
@@ -25,7 +25,7 @@
                 alt="image/GIF description"
                 src="image link"
                 caption="[image caption](https://example.com)") }}
-#} -->
+--> #}
 
 {% if src != "image link" %}
     {# Only validate against placeholders if we're not in the example #}