I think this currently has to be a single line, I'll look at changing that. This just ends up in a json field called `description` as a  string, it would be possible to put markdown in it, but I don't think swagger handles it.