Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Swagger/OpenAPI to a human readable document (Excel, Word ...) conversion

is there some tool to generate rest API specification in a MS Excel/MS Word format or any other human friendly table-like document from Swagger/OpenAPI spec in YAML. The result should be accessible to BA and web dev with minimum corrections. I have no particular suggestions regarding columns and structure, the more readable the better.

Preferably script in python or js, but Win10 tool and online are ok. If you suggest a generic YAML or Json CSV/HTML table converter, please indicate why do you think it is great for this task.

Update. Online Swagger Editor actually did decent job and I can copy the result to OpenOffice Writer, then manually edit for best appearance. In Calc the documentation looks bleaker, yet I still hope the docs could look crisper and more appealing with a table processor.

like image 809
Serge Avatar asked Apr 10 '26 20:04

Serge


1 Answers

Look at my project https://github.com/pszybiak/openapi-2-excel. It is still under development but you can generate most of information. Please feel free to leave a comment or report bugs and development suggestions.

like image 123
Pawel Avatar answered Apr 13 '26 15:04

Pawel



Donate For Us

If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!