Update syntax guide about comments (#414)

* Update syntax guide about comments

* update TOC

Author: leemthompo

docs/docset.yml

@@ -72,6 +72,7 @@ toc:
       - file: admonitions.md
       - file: automated_settings.md
       - file: code.md
+      - file: comments.md
       - file: conditionals.md
       - file: dropdowns.md
       - file: example_blocks.md

docs/syntax/comments.md

@@ -0,0 +1,15 @@
+# Comments
+
+## Single line comments
+
+Use `%` to add single-line comments.
+
+```markdown
+% This is a comment
+```
+
+Make sure to add a space after the `%`.
+
+::::{note}
+Currently multi-line comments are not supported.
+::::

docs/syntax/sundries.md

@@ -32,9 +32,3 @@ using `\` at the end of a line.
 
 Same as using `<hr>` HTML tag:
 ***
-
-## Comments
-
-% Here is a comment
-
-You can use `%` to add comments in the markdown. Those comment will not be rendered in the HTML output. Look at the markdown source to see the comment above this paragraph.