diff --git a/README.md b/README.md
index 464ffb7..ac8beaf 100644
--- a/README.md
+++ b/README.md
@@ -45,5 +45,5 @@ How to tweak
 ------------
 
 Syntax highlighting is done by pluggable highlighter scripts.  See the
-[`highlighters` directory](./highlighters) for documentation and configuration
-settings.
+[documentation on highlighters](docs/highlighters.md) for details and
+configuration settings.
diff --git a/docs/highlighters.md b/docs/highlighters.md
index cb13d50..266abe1 100644
--- a/docs/highlighters.md
+++ b/docs/highlighters.md
@@ -3,12 +3,19 @@ zsh-syntax-highlighting / highlighters
 
 Syntax highlighting is done by pluggable highlighters:
 
-* `main` - the base highlighter, and the only one active by default.
-* `brackets` - matches brackets and parenthesis.
-* `pattern` - matches user-defined patterns.
-* `cursor` - matches the cursor position.
-* `root` - triggered if the current user is root.
-* `line` - applied to the whole command line
+* `main` - the base highlighter, and the only one [active by default][1].
+* `brackets` - [matches brackets][2] and parenthesis.
+* `pattern` - matches [user-defined patterns][3].
+* `cursor` - matches [the cursor position][4].
+* `root` - highlights the whole command line [if the current user is root][5].
+* `line` - applied to [the whole command line][6].
+
+[1]: highlighters/main.md
+[2]: highlighters/brackets.md
+[3]: highlighters/pattern.md
+[4]: highlighters/cursor.md
+[5]: highlighters/root.md
+[6]: highlighters/line.md
 
 
 How to activate highlighters
@@ -27,15 +34,16 @@ How to tweak highlighters
 -------------------------
 
 Highlighters look up styles from the `ZSH_HIGHLIGHT_STYLES` associative array.
-Navigate into each highlighter directory to see what styles (keys) it defines;
-the syntax for values is the same as the syntax of "types of highlighting" of
-the zsh builtin `$zle_highlight` array, which is documented in [the `zshzle(1)`
-manual page][zshzle-Character-Highlighting].
+Navigate into the [individual highlighters' documentation](highlighters/) to
+see what styles (keys) each highlighter defines; the syntax for values is the
+same as the syntax of "types of highlighting" of the zsh builtin
+`$zle_highlight` array, which is documented in [the `zshzle(1)` manual
+page][zshzle-Character-Highlighting].
 
 [zshzle-Character-Highlighting]: http://zsh.sourceforge.net/Doc/Release/Zsh-Line-Editor.html#Character-Highlighting
 
 Some highlighters support additional configuration parameters; see each
-highlighter's documentation for details.
+highlighter's documentation for details and examples.
 
 
 How to implement a new highlighter
diff --git a/highlighters/README.md b/highlighters/README.md
deleted file mode 120000
index 7b048c0..0000000
--- a/highlighters/README.md
+++ /dev/null
@@ -1 +0,0 @@
-../docs/highlighters.md
\ No newline at end of file
diff --git a/highlighters/README.md b/highlighters/README.md
new file mode 100644
index 0000000..8490ddf
--- /dev/null
+++ b/highlighters/README.md
@@ -0,0 +1,8 @@
+zsh-syntax-highlighting / highlighters
+======================================
+
+Navigate into the individual highlighters' documentation to see
+what styles (`$ZSH_HIGHLIGHT_STYLES` keys) each highlighter defines.
+
+Refer to the [documentation on highlighters](../docs/highlighters.md) for further
+information.