diff --git a/knowledge base/shuf.md b/knowledge base/shuf.md
new file mode 100644
index 0000000..655ae93
--- /dev/null
+++ b/knowledge base/shuf.md	
@@ -0,0 +1,17 @@
+# Shuf
+
+## TL;DR
+
+```shell
+# randomize the order of lines in a file and output the result
+shuf filename
+
+# only output the first 5 entries of the result
+shuf -n 5 filename
+
+# write output to another file
+shuf filename -o output_filename
+
+# generate random numbers in range 1-10:
+shuf -i 1-10
+```