diff --git a/README.md b/README.md
index 0c6beaf..61b72d6 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,20 @@ or just echo the code directly
 echo "main = \\ x . x;" | lambda
 ```
 
+### Syntax
+
+Lambda expression
+```
+\ param1 param2 param3 ... param3 . body
+```
+
+Name definition
+```
+identifier = lambda expression | identifier;
+```
+
+For a file to be able to be run, it needs to define a `main` function.
+
 ## Future ideas
 
 - [ ] types