Page cards
Page cards are full-width, clickable navigation rows that link to another page in the docs. Use them to build index-style landing pages where you want each destination to be visually prominent and immediately navigable.
Callout boxes for notes, warnings, tips, and other asides.
A page card takes a single Markdown link as its argument. The description body is optional.
:::{page-card} [Code blocks](code.md)
Syntax-highlighted code with copy button, callouts, and console output support.
:::
:::{page-card} [Tables](tables.md)
:::
Consecutive page cards stack into a list automatically — no container directive required.
Callout boxes for notes, warnings, tips, and important asides.
Organise related content into selectable tab panels.
Step-by-step instructions with numbered visual progression.
:::{page-card} [Admonitions](admonitions.md)
Callout boxes for notes, warnings, tips, and important asides.
:::
:::{page-card} [Tabs](tabs.md)
Organise related content into selectable tab panels.
:::
:::{page-card} [Stepper](stepper.md)
Step-by-step instructions with numbered visual progression.
:::
The most common use — a relative path to another .md file in the same documentation set:
:::{page-card} [Configuration](./configuration.md)
How to configure contexts and credentials.
:::
Page cards support cross-repository links using the scheme://path syntax:
:::{page-card} [Getting Started](docs-content://get-started/introduction.md)
Learn the basics of the Elastic Stack.
:::
Page cards are for in-docs navigation only. Absolute http:// or https:// URLs are rejected at build time:
:::{page-card} [Elastic website](https://elastic.co) ← build error
:::
Use a standard Markdown link or a button for external destinations.
| Part | Required | Description |
|---|---|---|
| Argument | Yes | A Markdown link [Title](url) — title becomes the card heading, url must be a local .md path or a crosslink. |
| Body | No | One or more lines of description text rendered below the title. |