diff --git a/docs/languages/vscode-yaml.md b/docs/languages/vscode-yaml.md
index 90dbbce..273da6a 100644
--- a/docs/languages/vscode-yaml.md
+++ b/docs/languages/vscode-yaml.md
@@ -4,4 +4,16 @@ sidebar_position: 2
 
 # VS Code YAML
 
-[Visit the GitHub](https://github.com/redhat-developer/vscode-yaml)
\ No newline at end of file
+[![Link to GitHub](https://img.shields.io/badge/GitHub-redhat%E2%80%93developer%2Fvscode%E2%80%93yaml-GitHub?style=for-the-badge&logo=github&logoColor=white&color=black)](https://github.com/redhat-developer/vscode-yaml)
+[![Visual Studio Marketplace](https://img.shields.io/visual-studio-marketplace/v/redhat.vscode-yaml?color=informational&logo=visualstudiocode&style=for-the-badge&label=VS%20Marketplace)](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)
+[![Installs](https://img.shields.io/visual-studio-marketplace/i/redhat.vscode-yaml?logo=visualstudiocode&color=informational&style=for-the-badge)](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)
+
+VS Code YAML provides comprehensive YAML Language support to Visual Studio Code, via the yaml-language-server.
+It has built-in Kubernetes syntax support,
+and can validate documents against schemas from [JSON Schema Store](https://www.schemastore.org/json/).
+
+![Screencapture of VS Code demonstrating the various features that VS Code YAML provides](/img/vscode-yaml.gif)
+
+For a complete list of features, please see the GitHub README.
+
+[Visit the GitHub](https://github.com/redhat-developer/vscode-yaml)
diff --git a/static/img/vscode-yaml.gif b/static/img/vscode-yaml.gif
new file mode 100644
index 0000000..ca46bf8
Binary files /dev/null and b/static/img/vscode-yaml.gif differ