diff --git a/plugins/osx/README.md b/plugins/osx/README.md
index 3c12b4d..c0b22be 100644
--- a/plugins/osx/README.md
+++ b/plugins/osx/README.md
@@ -1,13 +1,32 @@
-Provides the following commands:
+OSX
+===
+Defines [Mac OS X][1] aliases and functions.
 
-- `tab` create a new tab (works in both _Terminal_ and _iTerm_).
+Aliases
+-------
+   change to the current _Finder_ directory.
+ - `cdf` change the current working director to the current _Finder_ directory.
+ - `pushdf` push the current working directory onto the directory queue and
+ - `ql` quick look at files.
+ - `rm-osx-cruft` delete .DS\_Store, \_\_MACOSX cruft.
+
+Functions
+---------
+
+- `manb` open _man_ pages in [_Bwana.app_][2].
+- `manp` open _man_ pages in _Preview.app_.
 - `pfd` print current _Finder_ directory.
 - `pfs` print current _Finder_ selection.
-- `cdf` cd to current _Finder_ directory.
-- `pushdf` pushd to current _Finder_ directory.
-- `ql` quick look at files.
-- `manp` open MAN pages in _Preview.app_.
-- `manb` open MAN pages in _Bwana.app_.
+- `tab` create a new tab (works in both _Terminal_ and [_iTerm_][3]).
 - `trash` move files and folders to _Trash_.
-- `rm-osx-cruft` delete .DS_Store, \__MACOSX cruft.
+
+Authors
+-------
+*The authors of this plugin should be contacted via the GitHub issue tracker.*
+
+ - [Sorin Ionescu](/sorin-ionescu)
+
+[1]: http://www.apple.com/macosx/
+[2]: http://bruji.com/bwana/
+[3]: http://www.iterm2.com/