diff --git a/pages/common/pup.md b/pages/common/pup.md
new file mode 100644
index 0000000000..56c38853fd
--- /dev/null
+++ b/pages/common/pup.md
@@ -0,0 +1,28 @@
+# pup
+
+> HTML parsing tool.
+
+- Transform raw HTML file into a cleaned, indented, and colored format:
+
+`cat {{index.html}} | pup --color`
+
+- Filter HTML by element tag name:
+
+`cat {{index.html}} | pup '{{tag}}'`
+
+- Filter HTML by id:
+
+`cat {{index.html}} | pup '{{tag#id}}'`
+
+- Filter HTML by attribute value:
+
+`cat {{index.html}} | pup '{{tag[attribute="value"}}'`
+
+- Print all text from selected nodes and children:
+
+`cat {{index.html}} | pup '{{tag}} text{}`
+
+- Print HTML as JSON:
+
+`cat {{index.html}} | pup '{{tag}} json{}'`
+