mkdocs-plugins icon indicating copy to clipboard operation
mkdocs-plugins copied to clipboard

Response and request description not rendered.

Open eo33 opened this issue 1 year ago • 2 comments

Hi everyone 👋 I'm trying to render my OpenAPI Spec (OAS) here in MKDocs-material. I've done some research and I found a plugin called neoteroi-mkdocs that I should be able to use to render my OAS file. I tried it and was able to render the OAS document by adding a [OAD(./oas/account.yaml)] in my Markdown file. However, it doesn't show the description of the request and response body in a table format. This is what it looks like:

image

I've also tried manually essentials-openapi that can convert OpenAPI document (OAD) to Markdown format using this command:

oad gen-docs -s "./oas/account.yaml" -d "./docs/output.md"

The command ran successfully and it created a Markdown file, but it is still not showing the response and request body in the table. This is my public repo: https://github.com/eo33/tfb_oas

eo33 avatar Dec 07 '24 08:12 eo33

Hi @eo33 Thank you for opening the issue and providing an example. I take a look when I get a free moment.

RobertoPrevato avatar Apr 18 '25 05:04 RobertoPrevato

Hi @RobertoPrevato @eo33 does you find a way to render it full? I occur a bug which request and reponse table also empty. Tried with oad manually too

daydreamer95 avatar May 21 '25 12:05 daydreamer95