diff --git a/docs/docset.yml b/docs/docset.yml
index a8a851bd..dcf4a1dc 100644
--- a/docs/docset.yml
+++ b/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
diff --git a/docs/syntax/comments.md b/docs/syntax/comments.md
new file mode 100644
index 00000000..b2697220
--- /dev/null
+++ b/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.
+::::
\ No newline at end of file
diff --git a/docs/syntax/sundries.md b/docs/syntax/sundries.md
index 6e6eb552..8c5f417e 100644
--- a/docs/syntax/sundries.md
+++ b/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.