diff --git a/pages/common/trans.md b/pages/common/trans.md
new file mode 100644
index 0000000000..644e0849b7
--- /dev/null
+++ b/pages/common/trans.md
@@ -0,0 +1,23 @@
+# trans
+
+> **Translate Shell** is a command-line translator.
+
+- Translate a word (language is detected automatically):
+
+`trans "{{word_or_sentence_to_translate}}"`
+
+- Get a brief translation:
+
+`trans --brief "{{word_or_sentence_to_translate}}"`
+
+- Translate a word into french:
+
+`trans :fr {{word}}`
+
+- Translate from a specific language:
+
+`trans de:en {{handy}}`
+
+- Use `trans` as a dictionary:
+
+`trans -d handy`