diff --git a/src/guide/template-syntax.md b/src/guide/template-syntax.md
new file mode 100644
index 0000000000..1cadf87c0e
--- /dev/null
+++ b/src/guide/template-syntax.md
@@ -0,0 +1,3 @@
+:::tip Vue-specific Attributes
+You might see HTML validators or IDEs warn that attributes like `v-if`, `@click`, or `v-bind` are invalid. These are Vue-specific directives that are processed by Vue’s template compiler and are not standard HTML attributes. This is expected and safe to ignore in Vue templates.
+:::