awful.rules: Use markdown for documentation.

The old way of documenting was broken either way with the current ldoc
config and markdown is much nicer to read and write.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>