diff --git a/site/_includes/bugify.html b/site/_includes/bugify.html
index cd8ab79a50..7f3340421a 100644
--- a/site/_includes/bugify.html
+++ b/site/_includes/bugify.html
@@ -1,7 +1,7 @@
 {%- comment -%}
-Usage: {% include bugify.html content=text %},
-where content is a string that contains a bug reference name and id.
-e.g. Bootstrap#19984
+  Usage: include bugify.html content=text,
+  where content is a string that contains a bug reference name and id.
+  e.g. Bootstrap#19984
 {%- endcomment -%}
 
 {%- assign words = include.content | split: " " -%}
diff --git a/site/_includes/callout.html b/site/_includes/callout.html
index 067e49f198..2b446b0abc 100644
--- a/site/_includes/callout.html
+++ b/site/_includes/callout.html
@@ -1,7 +1,7 @@
 {%- comment -%}
-Usage: {% include callout.html content=callout type="type" %},
-where content is a capture with the content
-and type is one of: info (default), danger, warning
+  Usage: include callout.html content=callout type="type",
+  where content is a capture with the content
+  and type is one of: info (default), danger, warning
 {%- endcomment -%}
 {%- assign css_class = include.type | default: "info" -%}
 <div class="bd-callout bd-callout-{{ css_class }} no_toc_section">
diff --git a/site/_includes/example.html b/site/_includes/example.html
index 308d2850b2..dd1cc63823 100644
--- a/site/_includes/example.html
+++ b/site/_includes/example.html
@@ -1,17 +1,19 @@
 {%- comment -%}
-Usage: {% include example.html content=markup %},
-where content is a capture with the HTML content
-id - null (default)
-class - "bd-example" (default)
-optional: hide_preview - disabled (default)
-optional: hide_markup - disabled (default)
+  Usage: include example.html content=markup [args],
+  where content is a capture with the HTML content
+
+  args can be one of the following:
+    id - null (default)
+    class - "bd-example" (default)
+    optional: hide_preview - disabled (default)
+    optional: hide_markup - disabled (default)
 {%- endcomment -%}
 
-{%- assign preview_id = include.id -%}
-{%- assign preview_class = include.class -%}
+{%- assign id = include.id -%}
+{%- assign class = include.class -%}
 
 {%- if include.hide_preview == null -%}
-<div{% if preview_id %} id="{{ preview_id }}"{% endif %} class="bd-example{% if preview_class %} {{ preview_class }}{% endif %}">
+<div{% if id %} id="{{ id }}"{% endif %} class="bd-example{% if class %} {{ class }}{% endif %}">
   {{- include.content -}}
 </div>
 {%- endif -%}