From 5ccdfe355739229573b20a2fa2ee49e38e3868fe Mon Sep 17 00:00:00 2001
From: Scott Wu <sw@scottwu.ca>
Date: Fri, 21 Aug 2026 00:05:45 +0800
Subject: [PATCH] docs: note comments within tags possibility (#18482)

Co-authored-by: Simon H <5968653+dummdidumm@users.noreply.github.com>
---
 .../docs/03-template-syntax/01-basic-markup.md        | 11 +++++++++++
 1 file changed, 11 insertions(+)

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>
+```