diff --git a/README.asciidoc b/README.asciidoc
index f41c9e78..5f03a867 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -587,6 +587,13 @@ Basic Commands
       `:nop %sh{ echo echo tchou }` will not, but both will execute the
       shell command.
 
+Multiple commands
+~~~~~~~~~~~~~~~~~
+
+Multiple commands can be separated either by new lines or by semicolons,
+as such a semicolon must be escaped with `\;` to be considered as a literal
+semicolon argument.
+
 String syntax
 ~~~~~~~~~~~~~