diff --git a/pages/common/vdir.md b/pages/common/vdir.md
new file mode 100644
index 0000000000..a87347f746
--- /dev/null
+++ b/pages/common/vdir.md
@@ -0,0 +1,32 @@
+# vdir
+
+> List directory contents.
+> Drop-in replacement for `ls -l`.
+
+- List files and directories in the current directory, one per line, with details:
+
+`vdir`
+
+- List with sizes displayed in human readable units (KB, MB, GB):
+
+`vdir -h`
+
+- List including hidden files (starting with a dot):
+
+`vdir -a`
+
+- List files and directories sorting entries by size (largest first):
+
+`vdir -S`
+
+- List files and directories sorting entries by modification time (newest first):
+
+`vdir -t`
+
+- List grouping directories first:
+
+`vdir --group-directories-first`
+
+- Recursively list all files and directories in a specific directory:
+
+`vdir --recursive {{path/to/directory}}`