title: Formatting in springfox-swagger2
body: <p>I have made a Spring Boot web service that I am adding documentation to. I'm using the springfox-swagger2 library to add the documentation. For example, I have:</p>
  
  <pre><code>@RestController
  @Api(description = "A long description of my API that needs to span multiple lines", tags = "My Endpoint")
  public class MyEndpoint {
     // rest of code
  }
  </code></pre>
  
  <p>The description for the endpoint is rather long. There's an ordering that the users need to follow and some key parameters that I'd like to point out to users in the documentation. Is it possible to add nicer formatting to the description in the @Api annotation? </p>
  
  <p>Right now, it is inlined with the tag and output looks like:</p>
  
  <p>"My Endpoint : A long description..."</p>
  
  <p>Ideally, I'd be able to add some HTML or CSS formatting to it.</p>
  
  <p>Thanks! </p>
  
  <p><strong>EDIT per comment:</strong></p>
  
  <p>I am using springfox-swagger2 version 2.7.0. </p>
  
  <p>When I attempt to put markdown in my Api.description:</p>
  
  <pre><code>@Api(description = "#Heading \n Some description")
  </code></pre>
  
  <p>I get the following in my swagger.json:</p>
  
  <pre><code>{
     "name": "My Endpoint",
     "description": "#Heading \n Some description"
  }
  </code></pre>