Skip to main content

​
Image

​
Using Markdown

The markdown syntax lets you add images using the following code 
![title](/path/image.jpg)
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 
<img height="200" src="/path/image.jpg" />

​
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. 
<iframe src="https://www.youtube.com/embed/4KzFe50RQkQ"> </iframe>
Last modified on March 6, 2026