Essentials

Images and Embeds

Add images, videos, and embedded content to your pages.

Images

Basic image

Use standard markdown syntax for images:

![Alt text](/img/example.png)

Image with caption

Images can include descriptive alt text for accessibility:

![Dashboard showing the main metrics panel](/img/dashboard.png)

Embeds

iframes

Embed external content using HTML iframes:

<iframe
  src="https://example.com/embed"
  width="100%"
  height="400"
  frameBorder="0"
></iframe>

Videos

Embed videos with a direct link:

<video controls width="100%">
  <source src="/videos/demo.mp4" type="video/mp4" />
</video>

Best practices

• Always include descriptive alt text for images
• Use relative paths for images stored in your project
• Optimize images for web before uploading
• Consider dark mode when choosing image backgrounds