diff --git a/docs/basic-usage.md b/docs/basic-usage.md
index 22bd511..e88b739 100644
--- a/docs/basic-usage.md
+++ b/docs/basic-usage.md
@@ -7,6 +7,9 @@ Tempblot files are `.blot` files with two main blocks: `<setup>` and `<output>`.
 Use `<setup>` for TypeScript that prepares values. Use `<output>` for the text
 you want Tempblot to generate.
 
+For VS Code syntax highlighting and IntelliSense, install the
+[Tempblot Language Features extension](https://marketplace.visualstudio.com/items?itemName=tempblot.tempblot-vsc).
+
 ```blot
 <setup>
 const message = "Hello from Tempblot";
diff --git a/packages/compiler/README.md b/packages/compiler/README.md
index 7328420..adeddf4 100644
--- a/packages/compiler/README.md
+++ b/packages/compiler/README.md
@@ -66,6 +66,10 @@ const params = useParams<{ name: string }>();
 npm install tempblot
 ```
 
+# VS Code Extension
+
+Install [Tempblot Language Features](https://marketplace.visualstudio.com/items?itemName=tempblot.tempblot-vsc) for `.blot` syntax highlighting and IntelliSense in VS Code.
+
 # Prerequisites
 
 - Node v22.18+