# Images and embeds
> Enrich your documentation with visuals, videos, and interactive embeds.
Source: https://docs.doccupine.com/images-and-embeds
> For the complete documentation index, see [llms.txt](https://docs.doccupine.com/llms.txt).
# Images and embeds
Enrich your documentation with visuals, videos, and interactive embeds.
Display images, embed video content, or add interactive frames via iframes to supplement your docs.
## Images
Images enhance documentation with context, illustration, or decorative visual cues.
### Basic Image Syntax
Include an image in Markdown using the syntax below:
```md
```
Use clear, descriptive alt text for accessibility and better SEO. Alt text should describe the image’s appearance or content.
### HTML image embeds
Embed images in your Markdown content using HTML syntax.
```md
```
### Theme-aware images
Show different images depending on whether the user is in light or dark mode. Add the `light-only` or `dark-only` className to display an image exclusively in that theme.
```md
```
The `light-only` and `dark-only` classes work on any element, not just images. You can use them on videos, iframes, or wrapper divs too.
## Videos
Videos add a dynamic element to your documentation, engaging your audience and providing a more immersive experience.
### YouTube Embed
To embed a YouTube video, use the following syntax:
```html
```
### Self-hosted videos
Serve up your own video content using the `
```
### Theme-aware images
Show different images depending on whether the user is in light or dark mode. Add the `light-only` or `dark-only` className to display an image exclusively in that theme.
```md
```