# Frames
> Give images, videos, and diagrams a bordered container with an optional caption.
Source: https://docs.doccupine.com/frames
> For the complete documentation index, see [llms.txt](https://docs.doccupine.com/llms.txt).
# Frames
Give images, videos, and diagrams a bordered container with an optional caption.
A frame lifts visual content out of the surrounding prose. It centers whatever you put inside, wraps it in a soft border, and gives you a place to attach a caption - so screenshots and diagrams read as deliberate figures rather than stray images.
## Frame usage
Wrap any visual element in ``. Images, videos, iframes, and Mermaid diagrams all work.
```html
```
## Captions
Pass a `caption` to add a short line of context under the content, inside the frame.
```html
```
### Formatting inside captions
Captions understand a small set of inline Markdown: links, bold, italic, and inline code wrapped in backticks. Everything else is rendered as plain text.
```html
```
Links that point to a path starting with `/` are routed through Next.js, so they navigate without a full page reload. External links open in a new tab.
## Hints
A `hint` is a line of text that sits above the frame. Use it to set up what the reader is about to look at - captions work better for describing what they just saw.
```html
```
Hints accept the same inline Markdown as captions.
## Videos
Videos can be framed like any other element. A video with `autoPlay` is given `muted`, `loop`, and `playsInline` automatically, because browsers refuse to autoplay a video with sound and iOS otherwise opens it fullscreen.
```html
```
Set any of those attributes yourself and your value is kept. Videos without `autoPlay` are left exactly as you wrote them, so add `controls` when you want the reader to press play.
```html
```
## Multiple elements
A frame can hold more than one child. They stack vertically and stay centered, which is handy for a before-and-after pair under a single caption.
Frames don't replace alt text. Keep writing descriptive `alt` attributes - a caption is visible to everyone, while alt text is what screen readers announce in place of the image.
## Properties
The content to frame. Usually an image, video, iframe, or diagram.
Text shown inside the frame, centered below the content. Supports inline Markdown.
Text shown above the frame. Supports inline Markdown.