diff --git a/README.md b/README.md
index 5bcc208f..8bd807c8 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,9 @@ auto-complete and automatically generating [Typed-Document-nodes](https://the-gu
 - When you save it will generate `typed-document-nodes` for your documents and cast them to the correct type
 - Will warn you when you are importing from a file that is exporting fragments that you're not using
 
+> Note that this plugin does not do syntax highlighting, for that you still need something like
+> [the VSCode/... plugin](https://marketplace.visualstudio.com/items?itemName=GraphQL.vscode-graphql-syntax)
+
 ## Installation
 
 ```sh
@@ -41,6 +44,7 @@ when on a TypeScript file or adding a file like [this](https://github.com/0no-co
 
 > If you are using VSCode ensure that your editor is using [the Workspace Version of TypeScript](https://code.visualstudio.com/docs/typescript/typescript-compiling#_using-the-workspace-version-of-typescript)
 > this can be done by manually selecting it or adding a `.vscode/config.json` with the contents of
+>
 > ```json
 > {
 >   "typescript.tsdk": "node_modules/typescript/lib",
diff --git a/packages/graphqlsp/README.md b/packages/graphqlsp/README.md
index bf025e63..ab9a98c4 100644
--- a/packages/graphqlsp/README.md
+++ b/packages/graphqlsp/README.md
@@ -12,6 +12,9 @@ auto-complete and automatically generating [Typed-Document-nodes](https://the-gu
 - When you save it will generate `typed-document-nodes` for your documents and cast them to the correct type
 - Will warn you when you are importing from a file that is exporting fragments that you're not using
 
+> Note that this plugin does not do syntax highlighting, for that you still need something like
+> [the VSCode/... plugin](https://marketplace.visualstudio.com/items?itemName=GraphQL.vscode-graphql-syntax)
+
 ## Installation
 
 ```sh