This may become an issue later when generating non-HTML output; we have standardized to markdown in everything up to a template because it is easy to convert into other formattings. I am however not going to let it block the merge; this is something which we can resolve later-on