diff --git a/hacking/templates/rst.j2 b/hacking/templates/rst.j2
index 817b0554f68..012e6ee7cef 100644
--- a/hacking/templates/rst.j2
+++ b/hacking/templates/rst.j2
@@ -163,8 +163,9 @@ Common return values are documented here :doc:`common_return_values`, the follow
 Notes
 -----
 
+.. note::
 {% for note in notes %}
-.. note:: @{ note | convert_symbols_to_format }@
+    - @{ note | convert_symbols_to_format }@
 {% endfor %}
 {% endif %}