Admonitions in spec definition

[dmitriyrotaenko]

Hi, we're integrating Redocusaurus for our documentation. Really enjoy the project so far.

My question is whether Redocuaurus can somehow parse Docusaurus admonitions within the spec definition?

Here's a custom 'admonition' that I've created. Basically, a div with some styles.

And the spec definition looks like the following:

openapi: 3.0.1
info:
  title: "Public API"
  version: "1.0"
  description: |
    Gibberish gobbledygook
    
    # Div with custom styles
    <div class="tip">
      Useful tip
    <div/>

paths:
  /api/chat_public_keys:

Is it possible to to use Docusaurus admonitions in spec like so:

openapi: 3.0.1
info:
  title: "Public API"
  version: "1.0"
  description: |
    Gibberish gobbledygook
    
    # Admonition
   :::tip
   Very important tip.
   :::

paths:
  /api/chat_public_keys:

And if no, maybe there're some directions I can dig into? Any help and ideas appreciated 🙌

[rohit-gohri]

Sounds like a cool idea but not sure how this will work as the open api rendering is done by redoc and is out of my control