Links & Media·11 / 19

Images

Embed images in your Markdown content.

Images

Images in Markdown work similarly to links, but with an exclamation mark ! in front.

Syntax

![Alt text](image-url)

With Title

![Alt text](image-url "Optional title")

Examples

![Sunset](https://example.com/sunset.jpg)
![Logo](./images/logo.png "Company Logo")

Reference-Style Images

![Alt text][image-id]

[image-id]: https://example.com/image.png

Linked Images

Wrap an image in a link to make it clickable:

[![Alt text](image-url)](link-url)

Important Notes

  • Alt text is required for accessibility (screen readers)
  • Markdown doesn't support image resizing natively
  • For resizing, you can use HTML: <img src="url" width="300">
  • Use relative paths for local images
  • Use absolute URLs for web images

Best Practices

  • Always include meaningful alt text
  • Optimize image file sizes for faster loading
  • Use descriptive file names
  • Host images on reliable servers or CDNs

💡 Alt text describes the image for users who can't see it — it's important for accessibility!

Practice

Markdown Input
Live Preview

Image Practice

Basic Image

Placeholder

Linked Image

Click me