doc

doc/api/magic-sql.md

@@ -359,3 +359,40 @@ LIMIT 3
 ```{code-cell} ipython3
 %sql --file my-query.sql
 ```
+
+# Parameterizing arguments
+
+JupySQL supports variable expansion of arguments in the form of {{variable}}. This allows the user to specify arguments with placeholders that can be replaced by variables dynamically. The arguments supported are `section`, `close`, `alias`, `save` and `with`. 
+
+Let's see an example of creating a connection using an alias and closing the same through variable substitution.
+
+```{code-cell} ipython3
+alias = "db-four"
+
+%sql sqlite:///db_four.db --alias {{alias}}
+```
+
+```{code-cell} ipython3
+%sql --close {{alias}}
+```
+
+Let's see another example using `save`:
+
+```{code-cell} ipython3
+snippet = "larger_than_two"
+
+%%sql --save {{snippet}} --no-execute
+SELECT x, y
+FROM my_data
+WHERE x > 2
+```
+
+```{code-cell} ipython3
+%%sql --save {{snippet}}
+SELECT * 
+FROM {{snippet}}
+```
+
+
+
+