cmark (tested with current git version) doesn't seem to encode < and > in headers. For example, this: Glib::RefPtr<T> -------------- Converts: <h2>Glib::RefPtr<T></h2> (ideally the <T> should be <T> etc)