diff --git a/README.md b/README.md
index c01dccba6..fe63f48c8 100644
--- a/README.md
+++ b/README.md
@@ -43,3 +43,11 @@ Built in 379 ms
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
```
+
+**For Windows Users**
+
+We have found an issue with `highlight yaml` on Hugo.
+
+You will not be able to see any yaml syntax highlighting when previewing the docs at http://localhost:1313/ on a Windows machine.
+
+If run into this issue, you can try running Hugo on [WSL](https://docs.microsoft.com/en-us/windows/wsl/install) to preview the page.
\ No newline at end of file