diff --git a/src/docs/templates/slot.md.jinja2 b/src/docs/templates/slot.md.jinja2
index bde2209..c7a0985 100644
--- a/src/docs/templates/slot.md.jinja2
+++ b/src/docs/templates/slot.md.jinja2
@@ -45,6 +45,7 @@ Regex pattern: {{ '`' }}{{  element.pattern }}{{ '`' }}
 Mixin: {{ element.mixin }}
 {% endif -%}
 
+{% if element.comments %}
 ## Usage Notes
 
 {% set comments = element.comments | join('') %}
@@ -61,6 +62,7 @@ Mixin: {{ element.mixin }}
 {{ line }}
 {% endif %}
 {% endfor %}
+{% endif %}
 
 {% if schemaview.slot_parents(element.name) or schemaview.slot_children(element.name, mixins=False) %}