1

I'm trying to import Swagger JSON into AsciiDoc. To do that I'm trying to convert the Swagger JSON into markdown that can be read by AsciiDoc. I can't figure out how to do it. I've read that I will likely need to use swagger2markup. However, not being a Java programmer it's unclear how to use this. I got some clues from this answer but I can't get very far. It involves using J Unit and I don't know what to do with that and all that is required. Has anyone figured out how to do this?

Diana Bishop
  • 11
  • 1
  • 3
  • Make it [M.C.V.E](https://stackoverflow.com/help/mcve) please – Morse Apr 16 '18 at 02:58
  • It doesn't sound like an mvce situation to me. She's trying to figure out how to put some pieces together, I think. – SaganRitual Apr 16 '18 at 04:30
  • Yes, I am trying to figure out how to put this process together. All I have to go on, really, is the extended response from Aman Mohammed, but there is not enough detail for me to take action: https://stackoverflow.com/questions/30217910/generate-pdf-from-swagger-api-documentation – Diana Bishop Apr 16 '18 at 16:30
  • Try this blog post: https://jaxenter.de/restful-apis-dokumentieren-52052 – Tobias Dec 18 '18 at 12:29

1 Answers1

0

I got some help from a coworker on how to convert the my Swagger JSON to AsciiDoc markdown. The more complex instructions here were not what I needed. The CLI instructions here were. The simpler conversion process using the CLI as opposed to integrating Swagger2Markdown into a Java app were ideal.

Diana Bishop
  • 11
  • 1
  • 3