anchor.diff:  
   
   == Integration with spring-restdocs
  -https://github.com/spring-projects/spring-restdocs[spring-restdocs] can be used together with Swagger2Markup.
  -Swagger2Markup can include the generated examples snippets from spring-restdocs into the generated AsciiDoc document.
  -See https://github.com/spring-projects/spring-restdocs[spring-restdocs] how to configure it.
  -Currently spring-restdocs does not work support Markdown.
  +Swagger2Markup can be used together with https://github.com/spring-projects/spring-restdocs[spring-restdocs].
  +Swagger2Markup can include the generated HTTP request and response snippets from spring-restdocs into the generated AsciiDoc document. See https://github.com/spring-projects/spring-restdocs[spring-restdocs] how to configure it.
  +Currently spring-restdocs does only support AsciiDoc.
   
   Let's say you have a Swagger-annotated Spring RestController method with an ApiOperation value: `Add a new pet to the store`
   
  
positive.code: 
  image::images/generated_docs.PNG[generated_docs]
  
  You can generate your HTML5 and PDF documentation via the https://github.com/asciidoctor/asciidoctor-gradle-plugin[asciidoctor-gradle-plugin]. The following shows how to configure the Asciidoctor Gradle plugin. By default it searches for AsciiDoc files in "src/docs/asciidoc" and puts the HTML and PDF output into `build/asciidoc/html5` and `build/asciidoc/pdf`.
  
  [source]
  ----
  
negative.code: org.springframework.restdocs.outputDir = src/docs/asciidoc/generated
  ----
  
  The Swagger2MarkupConverter must know the base output directory of spring-restdocs.
  
  [source,java]
  ----
  