diff --git a/README.md b/README.md
index c30bc26f4d11b3b878c1e8b1d467228cee14ad85..00cd2e27f71541fa2e32ef221a1fd2cb829aafa5 100644
--- a/README.md
+++ b/README.md
@@ -6,37 +6,55 @@ **[Get it from the VS Code Marketplace →](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)**
 
 ## Features
 
-### Markup
+Tailwind CSS IntelliSense uses your projects Tailwind installation and configuration to provide suggestions as you type.
+
+It also includes features that improve the overall Tailwind experience, including improved syntax highlighting, and CSS previews.
+
+### HTML (including Vue, JSX, PHP etc.)
+
+- Class name suggestions, including support for Emmet syntax
+  - Suggestions include color previews where applicable, for example for text and background colors
+  - They also include a preview of the actual CSS for that class name
+- CSS preview when hovering over class names
+
+### CSS
 
+- Suggestions when using `@apply` and `config()`
+
 - class name suggestions, including support for Emmet
+
 - CSS preview when hovering over class names
 
+
 ### CSS
 
-# Tailwind CSS IntelliSense
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
+
 # Tailwind CSS IntelliSense
+### Markup
+
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
 # Tailwind CSS IntelliSense
-# Tailwind CSS IntelliSense
 
-# Tailwind CSS IntelliSense
 > [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
+
 
-# Tailwind CSS IntelliSense
+#### Suggestions when using `@apply` and `config()`
+
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
 **[Get it from the VS Code Marketplace →](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)**
 
-# Tailwind CSS IntelliSense
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
 ## Features
 
-# Tailwind CSS IntelliSense
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
 ### Markup
 
-# Tailwind CSS IntelliSense
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
 - class name suggestions, including support for Emmet
 
-# Tailwind CSS IntelliSense
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
 - CSS preview when hovering over class names
 
-### CSS
-
-# Tailwind CSS IntelliSense
+> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
 ### CSS

diff --git a/img/css-highlighting-after.png b/img/css-highlighting-after.png
new file mode 100644
index 0000000000000000000000000000000000000000..86a12fb8596e001e2c68d171733cb7950d66335c
Binary files /dev/null and b/img/css-highlighting-after.png differ

diff --git a/img/css-highlighting-before.png b/img/css-highlighting-before.png
new file mode 100644
index 0000000000000000000000000000000000000000..2eeffdc19d7293136e52f9426eb66456d0c1abb4
Binary files /dev/null and b/img/css-highlighting-before.png differ