diff --git a/osx/df.md b/osx/df.md
new file mode 100644
index 000000000..dc349158e
--- /dev/null
+++ b/osx/df.md
@@ -0,0 +1,12 @@
+# df
+
+> gives an overview of the file system disk space usage
+
+- display all file systems and their disk usage
+
+`df`
+
+- display all file systems and their disk usage in human readable form
+
+`df -h`
+