Skip to main content

​
Image

​
Using Markdown

The markdown syntax lets you add images using the following code
Note that the image file size must be less than 5MB. Otherwise, we recommend hosting on a service like Cloudinary or S3. You can then use that URL and embed.

​
Using embeds

To get more customizability with images, you can also use embeds to add images

​
Embeds and HTML elements


Mintlify supports HTML tags in Markdown. This is helpful if you prefer HTML tags to Markdown syntax, and lets you create documentation with infinite flexibility.

​
iFrames

Loads another HTML page within the document. Most commonly used for embedding videos.
Last modified on March 6, 2026