search

rohit-gohri / redocusaurus

OpenAPI for Docusaurus with Redoc
https://redocusaurus.vercel.app/
MIT License
600 stars 111 forks source link

Standalone redoc plugin #362

Closed gituserjava closed 1 month ago

gituserjava commented 1 month ago

Is there a way to just run "Docusaurus Plugin Redoc" standalone instead of setting up docusaurus? I am just looking for a tool to convert open api yaml file into mark down file and I need the source of the mark down file for other processing. Could you please let me know?

With the approach documented on "Getting Started/Installation" page I am able to get the final markdown UI, but I also need the source of the generated markdown file.

rohit-gohri commented 1 month ago

I don't think that's possible, it's out of scope for this project as it relies on a lot of docusaurus APIs

gituserjava commented 1 month ago

Ok, is there a way to just have the source of the html file that gets created? I can then use other tools to convert html to markdown.

rohit-gohri commented 1 month ago

You could use redoc directly - https://github.com/Redocly/redocly-cli/?tab=readme-ov-file#generate-api-reference-documentation