diff --git a/pages/linux/yank.md b/pages/linux/yank.md
new file mode 100644
index 0000000000..d44aed7adc
--- /dev/null
+++ b/pages/linux/yank.md
@@ -0,0 +1,19 @@
+# yank
+
+> Read input from stdin and display a selection interface that allows a field to be selected and copied to the clipboard.
+
+- Yank using the default delimiters (\f, \n, \r, \s, \t):
+
+`{{sudo dmesg}} | yank`
+
+- Yank an entire line:
+
+`{{sudo dmesg}} | yank -l`
+
+- Yank using a specific delimiter:
+
+`{{echo hello=world}} | yank -d {{=}}`
+
+- Only yank fields matching a specific pattern:
+
+`{{ps ux}} | yank -g {{"[0-9]+"}}`
diff --git a/pages/osx/yank.md b/pages/osx/yank.md
new file mode 100644
index 0000000000..d44aed7adc
--- /dev/null
+++ b/pages/osx/yank.md
@@ -0,0 +1,19 @@
+# yank
+
+> Read input from stdin and display a selection interface that allows a field to be selected and copied to the clipboard.
+
+- Yank using the default delimiters (\f, \n, \r, \s, \t):
+
+`{{sudo dmesg}} | yank`
+
+- Yank an entire line:
+
+`{{sudo dmesg}} | yank -l`
+
+- Yank using a specific delimiter:
+
+`{{echo hello=world}} | yank -d {{=}}`
+
+- Only yank fields matching a specific pattern:
+
+`{{ps ux}} | yank -g {{"[0-9]+"}}`