# Headings
Render Mintlify-style explicit Heading components in Plandalf MDX without rewriting imported section structure.
Source: /docs/components/headings
Last modified: 2026-06-20
Use Markdown headings for normal authored pages. Use `Heading` when imported Mintlify-style MDX already uses component headings, or when a generated page needs to pass the heading level, anchor, and visible title as props.


> **Default rule**
>

  Prefer `## Section title` when writing new docs by hand. Keep `
## for ported MDX, generated docs, or pages that need explicit heading props.


## Basic heading


## Structure your content


The component renders the same document heading semantics as Markdown. The id prop preserves deep links from imported Mintlify pages.

mdx title="basic-heading.mdx"

## Structure your content


## Slot content

<Heading level="3" id="slot-heading">
  Slot heading content


Use slot content when the source MDX passes children instead of a `title` prop.

```mdx title="slot-heading.mdx"

### Slot heading content


```

## Imported component index

Mintlify's component index uses explicit headings between component cards. Plandalf supports that pattern directly, while still styling the result like normal docs prose.


## Document your API


### [Fields](/docs/components/fields)


    Display request parameters, headers, body fields, and props.


### [Examples](/docs/components/examples)


    Show request and response examples beside API content.


```mdx title="imported-index-section.mdx"

## Document your API


### [Fields](/docs/components/fields)


    Display request parameters, headers, body fields, and props.


### [Examples](/docs/components/examples)


    Show request and response examples beside API content.


```

## Properties


- `level` (1 | 2 | 3 | 4 | 5 | 6; default: 2):
  Controls the rendered heading tag.


- `id` (string):
  Preserves the anchor target for table-of-contents links and imported deep links.


- `title` (string):
  Renders the visible heading text when children are not provided.


- `children` (string):
  Slot content for the visible heading text.


## Plandalf extensions


- `class | className` (string):
  Adds a class only when a page has a specific layout need.


## Related components


  - [Steps](/docs/components/steps): Use headings inside progressive procedures only when the step itself needs a section-level anchor.
  - [Cards](/docs/components/cards): Use headings before card groups, not inside every card.
  - [Reference](/docs/components/reference): Review aliases and imported MDX compatibility notes.