diff --git a/pages/docs/declarations.mdx b/pages/docs/declarations.mdx
new file mode 100644
index 0000000..f6b91ea
--- /dev/null
+++ b/pages/docs/declarations.mdx
@@ -0,0 +1,11 @@
+# Variables
+```c
+int x = 20;
+```
+
+# Functions
+```c
+int my_func(int x) {
+  printf("the number is: %d", x)
+}
+```