Hero

Full-width intro section for the top of a page. Headings and paragraphs become the header, links become action buttons, and code fences become copyable command blocks. The first link is styled as a primary button. For smaller, focused action blocks that can appear anywhere, use CTA instead.

Basic usage

A centered hero section with headline, description, and action buttons.

{% hero %}
# Build with refrakt.md

A content framework that turns Markdown into rich, semantic pages. Write standard Markdown — runes decide how it's interpreted.

- [Get started](/docs/getting-started)
- [View on GitHub](https://github.com/refrakt-md/refrakt)
{% /hero %}

Build with refrakt.md

A content framework that turns Markdown into rich, semantic pages. Write standard Markdown — runes decide how it's interpreted.

With command block

Code fences inside a hero become copyable command blocks — great for install commands on landing pages.

{% hero %}
# Get started in seconds

Scaffold a project and start writing.

```shell
npm create refrakt
```

- [Documentation](/docs/getting-started)
{% /hero %}

Get started in seconds

Scaffold a project and start writing.

npm create refrakt

Left-aligned

Use align="left" for a more editorial feel.

{% hero align="left" %}
# Documentation that writes itself

Semantic runes transform your Markdown into structured, accessible content.

- [Quick start](/docs/getting-started)
{% /hero %}

Documentation that writes itself

Semantic runes transform your Markdown into structured, accessible content.

Attributes

AttributeTypeDefaultDescription
backgroundstringCSS background color
backgroundImagestringBackground image URL
alignstringcenterContent alignment: left, center, or right