1diff --git a/plugins/textmate/README.md b/plugins/textmate/README.md
2new file mode 100644
3index 0000000000000000000000000000000000000000..8f86d35af27a9cd6b826d3f3167c5afb9f78df6a
4--- /dev/null
5+++ b/plugins/textmate/README.md
6@@ -0,0 +1,16 @@
7+# TextMate plugin
8+
9+The plugin adds aliases for the [TextMate](https://macromates.com) editor.
10+
11+To use it, add `textmate` to the plugins array of your zshrc file:
12+```
13+plugins=(... textmate)
14+```
15+
16+## Aliases
17+
18+| Alias | Command | Description |
19+|-----------------|-------------|---------------|
20+| tm | `mate .` | Open TextMate in the current directory. |
21+| tm \<directory> | `mate <directory>` `cd <directory>` | Open TextMate in the given directory and cd to it. |
22+| tm <*> | `mate "$@"` | Pass all arguments to `mate`. This allows for easy opening of multiple files. |