We write ours manually in markdown. I have yet to find a description format worth investing in that saves us enough time and is more expressive than that.
Using Swagger, which is fine. But it brings in a lot of baggage (Scala libs) which is unfortunate.