diff --git a/pages/common/trans.md b/pages/common/trans.md
new file mode 100644
index 000000000..244273cc5
--- /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 a word from German to English:
+
+`trans {{de}}:{{en}} {{Schmetterling}}`
+
+- Behave like a dictionary to get the meaning of a word:
+
+`trans -d {{word}}`