diff --git a/README.md b/README.md
index f70c6e0..76bb270 100644
--- a/README.md
+++ b/README.md
@@ -7,19 +7,21 @@ It is based on code from the old Awesome wiki.
 ## Installation
 
 ```
-$ git clone https://github.com/jcrd/awesome-ez.git
-$ cd awesome-ez
-$ luarocks make --local rockspec/awesome-ez-devel-1.rockspec
+git clone https://github.com/jcrd/awesome-ez.git
+cd awesome-ez
+luarocks make --local rockspec/awesome-ez-devel-1.rockspec
 ```
 
 ## Usage
 
 Require the library:
+
 ```lua
 local ez = require("awesome-ez")
 ```
 
 Use `ez.keytable` to define key bindings:
+
 ```lua
 local globalkeys = ez.keytable {
     ["M-Return"] = {awful.spawn, "xterm"},
@@ -28,6 +30,7 @@ local globalkeys = ez.keytable {
 ```
 
 Use `ez.btntable` to define button bindings:
+
 ```lua
 local clientbtns = ez.btntable {
     ["1"] = function (c) client.focus = c end,
@@ -45,15 +48,21 @@ descriptions of all functions.
 
 ### Modifiers
 
-The following modifiers can be identified by their shorthand characters
+The following modifiers can be identified by their default shorthand characters
 in key and button definitions:
 
-Modifier | Character
--------- | ---------
-Mod4     | M
-Mod1     | A
-Shift    | S
-Control  | C
+Character | Modifier
+--------- | --------
+M         | Mod4
+A         | Mod1
+S         | Shift
+C         | Control
+
+The `modifiers` table can be customized:
+
+```lua
+ez.modifiers["M"] = "Mod1"
+```
 
 ## License
 
diff --git a/init.lua b/init.lua
index 7126b6e..593930f 100644
--- a/init.lua
+++ b/init.lua
@@ -11,7 +11,7 @@ local gtable = require("gears.table")
 
 local ez = {}
 
-local modifiers = {
+ez.modifiers = {
     ["M"] = "Mod4",
     ["A"] = "Mod1",
     ["S"] = "Shift",
@@ -47,7 +47,7 @@ function ez.util.cb_from_table(cb)
         not (getmetatable(cb) and getmetatable(cb).__call) then
         local tbl = gtable.clone(cb, false)
         local func = table.remove(tbl, 1)
-        cb = function ()
+        cb = function()
             return func(unpack(tbl))
         end
     end
@@ -69,8 +69,8 @@ end
 function ez.util.parse_key(keydef)
     local modkeys = {}
     for _, key in ipairs(split(keydef, "-")) do
-        if modifiers[key] ~= nil then
-            table.insert(modkeys, modifiers[key])
+        if ez.modifiers[key] ~= nil then
+            table.insert(modkeys, ez.modifiers[key])
         else
             local group = string.match(key, "<(%w+)>")
             if group then
@@ -97,8 +97,8 @@ function ez.util.parse_button(btndef)
     end
     local modkeys = {}
     for _, key in ipairs(split(btndef, "-")) do
-        if modifiers[key] ~= nil then
-            table.insert(modkeys, modifiers[key])
+        if ez.modifiers[key] ~= nil then
+            table.insert(modkeys, ez.modifiers[key])
         else
             return modkeys, tonumber(key)
         end