How to Embed Images in Markdown

Markdown is used everywhere - GitHub, Reddit, documentation sites, blogs, and note-taking apps. Here's how to embed images using Markdown syntax.

Basic Image Syntax

!Alt text

- ! - Indicates an image
- [Alt text] - Description (shown if image fails to load)
- (URL) - The image URL

Image with Title

!Screenshot

The title appears as a tooltip on hover.

Linked Image

Shows the thumbnail, clicking opens the full image.

Platform-Specific Usage

GitHub README / Issues

## Screenshots
!Login page
!Dashboard

Reddit

Check out this bug I found:
!Bug screenshot

Notion

Paste the direct link and Notion auto-embeds it.

Obsidian

Standard Markdown image syntax works.

Getting Markdown Links from ImgLink

1. Upload your image to ImgLink - Free Image Hosting
2. After upload, find the "Markdown" row in the link list
3. Click the copy button
4. Paste in your Markdown document

ImgLink pre-formats the Markdown for you - no need to type the syntax manually.

Best Practices

1. Always include alt text - ![] with empty alt is bad practice
2. Use descriptive alt - ![Login form validation error] not ![image]
3. Link thumbnails to full images - For large screenshots
4. Host on CDN - ImgLink provides CDN delivery for fast loading

Frequently Asked Questions

Does Markdown support image sizing?

Standard Markdown doesn't. Some flavors (like GitHub) support HTML within Markdown for sizing:

Can I align images in Markdown?

Standard Markdown doesn't support alignment. Use HTML:

---

Start hosting images for free today. Upload your first image now or create a free account to unlock albums, dashboard analytics, and developer API access. It takes 10 seconds.