</>MDTooltools

Markdown Images

Embed an image in Markdown with an exclamation mark, alt text in square brackets, and the image URL in parentheses: ![alt text](image.png).

Basic image syntax

The alt text describes the image for screen readers and shows when the image fails to load — never leave it empty.

![Diagram of the conversion pipeline](/images/pipeline.png)
![Logo](logo.svg "MDTool logo")

Clickable images

Wrap the image syntax inside a link to make the image clickable.

[![Build status](badge.svg)](https://github.com/usmankhan045/mdtool/actions)

Resizing images

Markdown itself cannot set width or height. When your renderer allows inline HTML (GitHub does), use an img tag instead.

<img src="screenshot.png" alt="Editor screenshot" width="480" />

Frequently Asked Questions

How do I resize an image in Markdown?

Standard Markdown has no size syntax. Use an inline HTML img tag with a width attribute — GitHub, GitLab, and most static site generators render it.

Try it live

Paste this syntax into the free markdown to pdf converter and see the rendered output instantly — no signup, everything runs in your browser.

Open Markdown to PDF Converter

More Markdown syntax: