diff --git a/README.md b/README.md
index c989905..42e19b3 100644
--- a/README.md
+++ b/README.md
@@ -135,3 +135,6 @@ Flags:
 
 Use "yq [command] --help" for more information about a command.
 ```
+
+## Known Issues
+- `yq` attempts to preserve comment positions and whitespace as much as possible, but it does not handle all scenarios (see https://github.com/go-yaml/yaml/tree/v3 for details)