decorating markup

this is in response to issue #3