mintlify · mintlify-development · Sep 25, 2025 · Sep 25, 2025 · Sep 25, 2025 · Sep 25, 2025
diff --git a/components/accordions.mdx b/components/accordions.mdx
@@ -1,5 +1,5 @@
 ---
 title: "Accordions"
 description: "Collapsible components to show and hide content"
 icon: "chevron-down"
 ---
@@ -87,16 +87,22 @@
 
 ## Properties
 
-<ResponseField name="title" type="string" required>
-  Title in the Accordion preview.
-</ResponseField>
+### title
 
-<ResponseField name="description" type="string">
-  Detail below the title in the Accordion preview.
-</ResponseField>
+*Type:* `string` *Required:* Yes
 
-<ResponseField name="defaultOpen" type="boolean" default="false">
-  Whether the Accordion is open by default.
-</ResponseField>
+Title in the Accordion preview.
+
+### description
+
+*Type:* `string`
+
+Detail below the title in the Accordion preview.
+
+### defaultOpen
+
+*Type:* `boolean` *Default:* `false`
+
+Whether the Accordion is open by default.
 
 <IconsOptional />
diff --git a/components/banner.mdx b/components/banner.mdx
@@ -4,15 +4,15 @@
 icon: "layout-panel-top"
 ---

 Use banners to display important announcements, updates, or notifications across your entire documentation site. Banners appear at the top of every page, support Markdown formatting, and can be made dismissible.

 To add a banner, use the `banner` property in your `docs.json`:

 <CodeGroup>
  ```json Product announcements wrap
  "banner": {
    "content": "🚀 Version 2.0 is now live! See our [changelog](/changelog) for details.",
    "dismissible": true 
  }
  ```

@@ -33,10 +33,14 @@
 
 ## Properties
 
-<ResponseField name="content" type="string" required>
-  The banner message. Supports plain text and Markdown formatting.
-</ResponseField>
+### content
 
-<ResponseField name="dismissible" type="boolean">
-  Whether users can dismiss the banner. When `true`, users can close the banner and it won't reappear for their session. Defaults to `false`.
-</ResponseField>
+*Type:* `string` *Required:* Yes
+
+The banner message. Supports plain text and Markdown formatting.
+
+### dismissible
+
+*Type:* `boolean` *Default:* `false`
+
+Whether users can dismiss the banner. When `true`, users can close the banner and it won't reappear for their session.
diff --git a/components/cards.mdx b/components/cards.mdx
@@ -1,5 +1,5 @@
 ---
 title: "Cards"
 description: "Highlight main points or links with customizable layouts and icons"
 icon: "square-mouse-pointer"
 ---
@@ -100,32 +100,46 @@
 
 ## Properties
 
-<ResponseField name="title" type="string" required>
-  The title displayed on the card
-</ResponseField>
+### title
+
+*Type:* `string` *Required:* Yes
+
+The title displayed on the card.
 
 <IconsOptional />
 
-<ResponseField name="color" type="string">
-  Icon color as a hex code (for example, `#FF6B6B`).
-</ResponseField>
+### color
+
+*Type:* `string`
+
+Icon color as a hex code (for example, `#FF6B6B`).
+
+### href
+
+*Type:* `string`
+
+URL to navigate to when the card is clicked.
+
+### horizontal
+
+*Type:* `boolean`
+
+Display the card in a compact horizontal layout.
+
+### img
+
+*Type:* `string`
+
+URL or local path to an image displayed at the top of the card.
+
+### cta
 
-<ResponseField name="href" type="string">
-  URL to navigate to when the card is clicked.
-</ResponseField>
+*Type:* `string`
 
-<ResponseField name="horizontal" type="boolean">
-  Display the card in a compact horizontal layout.
-</ResponseField>
+Custom text for the action button.
 
-<ResponseField name="img" type="string">
-  URL or local path to an image displayed at the top of the card.
-</ResponseField>
+### arrow
 
-<ResponseField name="cta" type="string">
-  Custom text for the action button.
-</ResponseField>
+*Type:* `boolean`
 
-<ResponseField name="arrow" type="boolean">
-  Show or hide the link arrow icon.
-</ResponseField>
+Show or hide the link arrow icon.
diff --git a/components/expandables.mdx b/components/expandables.mdx
@@ -1,5 +1,5 @@
 ---
 title: "Expandables"
 description: "Toggle to display nested properties"
 icon: "list-tree"
 ---
@@ -36,10 +36,14 @@
 
 ## Properties
 
-<ResponseField name="title" type="string">
-  The name of the object you are showing.
-</ResponseField>
+### title
 
-<ResponseField name="defaultOpen" type="boolean" default="false">
-  Set to `true` for the expandable to open when the page loads
-</ResponseField>
+*Type:* `string`
+
+The name of the object you are showing.
+
+### defaultOpen
+
+*Type:* `boolean` *Default:* `false`
+
+Set to `true` for the expandable to open when the page loads.
diff --git a/components/fields.mdx b/components/fields.mdx
@@ -8,53 +8,65 @@

 ## Parameter field

 The `<ParamField>` component is used to define parameters for your APIs or SDKs. Adding a `ParamField` automatically adds an [API Playground](/api-playground/overview).

 <ParamField path="param" type="string" required>
  An example of a parameter field
 </ParamField>

 ```mdx
 <ParamField path="param" type="string" required>
  An example of a parameter field
 </ParamField>
 ```
 
 ### Properties
 
-<ParamField body="query, path, body, or header" type="string">
-  Whether the parameter is a query, path, body, or header. Followed by the
-  parameter name.
-</ParamField>
+#### query, path, body, or header
+
+*Type:* `string`
+
+Whether the parameter is a query, path, body, or header. Followed by the parameter name.
 
-<ParamField body="type" type="string">
-  Expected type of the parameter's value.
+#### type
+
+*Type:* `string`
+
+Expected type of the parameter's value.
 
-  Supports `number`, `string`, `boolean`, `object`.
+Supports `number`, `string`, `boolean`, `object`.
 
 Arrays can be defined using the `[]` suffix. For example `string[]`.
 
-</ParamField>
+#### required
 
-<ParamField body="required" type="boolean">
-  Indicate whether the parameter is required.
-</ParamField>
+*Type:* `boolean`
 
-<ParamField body="deprecated" type="boolean">
-  Indicate whether the parameter is deprecated.
-</ParamField>
+Indicate whether the parameter is required.
 
-<ParamField body="default" type="any">
-  Default value populated when the request value is empty
-</ParamField>
+#### deprecated
 
-<ParamField body="placeholder" type="string">
-  Placeholder text for the input in the playground.
-</ParamField>
+*Type:* `boolean`
 
-<ParamField body="children" type="string">
-  Description of the parameter (Markdown-enabled).
-</ParamField>
+Indicate whether the parameter is deprecated.
+
+#### default
+
+*Type:* `any`
+
+Default value populated when the request value is empty.
+
+#### placeholder
+
+*Type:* `string`
+
+Placeholder text for the input in the playground.
+
+#### children
+
+*Type:* `string`
+
+Description of the parameter (Markdown-enabled).
 
 ## Response field
 
@@ -65,37 +77,51 @@
 </ResponseField>

 ```mdx
 <ResponseField name="response" type="string" required>
  A response field example
 </ResponseField>
 ```
 
 ### Properties
 
-<ResponseField name="name" type="string" required>
-  The name of the response value.
-</ResponseField>
+#### name
 
-<ResponseField name="type" type="string" required>
-  Expected type of the response value. This can be any arbitrary string.
-</ResponseField>
+*Type:* `string` *Required:* Yes
 
-<ResponseField name="default" type="string">
-  The default value.
-</ResponseField>
+The name of the response value.
 
-<ResponseField name="required" type="boolean">
-  Indicate whether the response is required.
-</ResponseField>
+#### type
 
-<ResponseField name="deprecated" type="boolean">
-  Whether a field is deprecated.
-</ResponseField>
+*Type:* `string` *Required:* Yes
 
-<ResponseField name="pre" type="string[]">
-  Labels that are shown before the name of the field.
-</ResponseField>
+Expected type of the response value. This can be any arbitrary string.
 
-<ResponseField name="post" type="string[]">
-  Labels that are shown after the name of the field.
-</ResponseField>
+#### default
+
+*Type:* `string`
+
+The default value.
+
+#### required
+
+*Type:* `boolean`
+
+Indicate whether the response is required.
+
+#### deprecated
+
+*Type:* `boolean`
+
+Whether a field is deprecated.
+
+#### pre
+
+*Type:* `string[]`
+
+Labels that are shown before the name of the field.
+
+#### post
+
+*Type:* `string[]`
+
+Labels that are shown after the name of the field.
diff --git a/components/frames.mdx b/components/frames.mdx
@@ -20,9 +20,11 @@
 
 ## Properties
 
-<ResponseField name="caption" type="string">
-  Optional caption text to show centered under your component.
-</ResponseField>
+### caption
+
+*Type:* `string`
+
+Optional caption text to show centered under your component.
 
 <CodeGroup>
 

diff --git a/components/icons.mdx b/components/icons.mdx
@@ -8,7 +8,7 @@

 Use icons from Font Awesome, Lucide, SVGs, external URLs, or files in your project to enhance your documentation.

 <Icon icon="flag" size={32} />

 ```mdx Icon example
 <Icon icon="flag" size={32} />
@@ -16,7 +16,7 @@

 ## Inline icons

 Icons are placed inline when used within a paragraph.

 <Icon icon="flag" iconType="solid" /> The documentation you want, effortlessly.

@@ -28,10 +28,14 @@
 
 <IconsRequired />
 
-<ResponseField name="color" type="string">
-  The color of the icon as a hex code (for example, `#FF5733`).
-</ResponseField>
+### color
 
-<ResponseField name="size" type="number">
-  The size of the icon in pixels.
-</ResponseField>
+*Type:* `string`
+
+The color of the icon as a hex code (for example, `#FF5733`).
+
+### size
+
+*Type:* `number`
+
+The size of the icon in pixels.
diff --git a/components/steps.mdx b/components/steps.mdx
@@ -1,5 +1,5 @@
 ---
 title: "Steps"
 description: "Sequence content using the Steps component"
 icon: "list-todo"
 ---
@@ -36,30 +36,42 @@
 
 ## Steps properties
 
-<ResponseField name="children" type="ReactElement<StepProps>[]" required>
-  A list of `Step` components.
-</ResponseField>
+### children
 
-<ResponseField name="titleSize" type="string" default="p">
-  The size of the step titles. One of `p`, `h2`, and `h3`.
-</ResponseField>
+*Type:* `ReactElement<StepProps>[]` *Required:* Yes
+
+A list of `Step` components.
+
+### titleSize
+
+*Type:* `string` *Default:* `p`
+
+The size of the step titles. One of `p`, `h2`, and `h3`.
 
 ## Individual step properties
 
-<ResponseField name="children" type="string | ReactNode" required>
-  The content of a step either as plain text or components.
-</ResponseField>
+### children
+
+*Type:* `string | ReactNode` *Required:* Yes
+
+The content of a step either as plain text or components.
 
 <IconsOptional />
 
-<ResponseField name="title" type="string">
-  The title is the primary text for the step and shows up next to the indicator.
-</ResponseField>
+### title
+
+*Type:* `string`
+
+The title is the primary text for the step and shows up next to the indicator.
+
+### stepNumber
+
+*Type:* `number`
+
+The number of the step.
+
+### titleSize
 
-<ResponseField name="stepNumber" type="number">
-  The number of the step.
-</ResponseField>
+*Type:* `string` *Default:* `p`
 
-<ResponseField name="titleSize" type="string" default="p">
-  The size of the step titles. One of `p`, `h2`, and `h3`.
-</ResponseField>
+The size of the step titles. One of `p`, `h2`, and `h3`.