diff --git a/documentation/docs/03-template-syntax/01-basic-markup.md b/documentation/docs/03-template-syntax/01-basic-markup.md
index feecfe033e..436f307f84 100644
--- a/documentation/docs/03-template-syntax/01-basic-markup.md
+++ b/documentation/docs/03-template-syntax/01-basic-markup.md
@@ -215,3 +215,14 @@ You can add a special comment starting with `@component` that will show up when
 	</h1>
 </main>
 ````
+
+You can also put JavaScript-style comments within tags between attributes:
+
+```svelte
+<div
+  // this is a comment!
+  data-foo="bar"
+>
+  foo bar
+</div>
+```