` when you set `Href`, as a plain `` otherwise.
## Basic use
```razor
```
## As a link
Setting `Href` renders the card as an anchor : the whole card becomes clickable.
```razor
```
Set `External="true"` to add `target="_blank"` and `rel="noopener"` : safe for outbound links.
```razor
```
## With an icon
Pass raw SVG markup as `IconSvg`. It renders inside a `.doc-card-icon` container above the title.
```razor
```
Write the SVG with single-quoted attributes so it fits inside the double-quoted `IconSvg` value.
The same attribute works on a `Card` written straight into the page:
- **Composable**: An inline card with an icon.
## With child content
Use `ChildContent` for anything richer than a description : lists, a code block, another primitive.
```razor
Bring your own component library, register it in one line with RegisterComponentsFromAssembly, and use its tags in markdown.
```
## In a grid
`Card`'s natural habitat is inside `CardGrid`, which lays out any number of children on a responsive grid.
```razor
```
## Props
| Name | Type | Default | Description |
|------|------|---------|-------------|
| `Title` | `string?` | `—` | Optional title, rendered as .doc-card-title. |
| `Description` | `string?` | `—` | Optional short description below the title. |
| `Href` | `string?` | `—` | When set, the whole card becomes a link pointing here. |
| `IconSvg` | `string?` | `—` | Raw SVG markup rendered above the title. Use single quotes inside it. |
| `External` | `bool` | `false` | When true (and Href set), adds target='_blank' and rel='noopener'. |
| `ChildContent` | `RenderFragment?` | `—` | Rich body content, rendered below the description. |
## See also
- [CardGrid](https://shelldocs.shellui.dev/docs/components/card-grid.md): Responsive layout wrapper for a set of cards.
- [LinkCard](https://shelldocs.shellui.dev/docs/components/link-card.md): Simpler variant : always a link, with a trailing arrow glyph.