How do I add an image in Markdown?

Write an exclamation mark, the alt text in square brackets and the image’s address in parentheses: ![alt text](https://example.com/image.png).

How do I resize an image in Markdown?

Plain Markdown can’t. Where HTML is allowed, use ; otherwise resize the image file itself.

Why doesn’t HushJot show the picture?

Loading a remote image tells its host your IP address and when you opened the note. HushJot is built so nobody learns that, so it shows remote images as links you can open on purpose.

Markdown guides

Markdown images. A link with a !

An image is a link with an exclamation mark in front: ![alt text](https://example.com/photo.jpg). The text in brackets is the alt text, read aloud by screen readers and shown when the image can’t load.

Try it in HushJot The whole cheat sheet

Images
Size and alt text
Questions

On the left, what you type. On the right, what you get. Every result here was rendered by HushJot itself.

Images

An image

![A cat asleep on a keyboard](https://example.com/cat.jpg)

🖼 A cat asleep on a keyboard

HushJot never fetches a remote image, so no image host learns when you open the note: it shows the image as a link you choose to open. Most other apps show the picture.

With a title

![Logo](https://example.com/logo.png "Our logo")

🖼 Logo

The title appears as a tooltip on hover.

Reference style

![The chart][chart]

[chart]: https://example.com/chart.png

🖼 The chart

Like reference links: the address is defined once, elsewhere.

Size and alt text

Resizing an image

Standard Markdown has no way to set an image’s size.
Apps that allow HTML accept <img src="…" width="300">, GitHub among them.
Some apps have their own syntax, such as Obsidian’s ![alt|300](…). It won’t work elsewhere.

Writing good alt text

Say what the image shows, as you would to someone on the phone.
Skip “image of”: screen readers already announce an image.
For a chart, give the takeaway, not the colours.

Questions

Images, answered.

How do I add an image in Markdown?: Write an exclamation mark, the alt text in square brackets and the image’s address in parentheses: ![alt text](https://example.com/image.png).
How do I resize an image in Markdown?: Plain Markdown can’t. Where HTML is allowed, use <img src="…" width="300">; otherwise resize the image file itself.
Why doesn’t HushJot show the picture?: Loading a remote image tells its host your IP address and when you opened the note. HushJot is built so nobody learns that, so it shows remote images as links you can open on purpose.

Keep going

More Markdown guides.

All 15 Markdown guides →

Write it, see it, keep it private.

HushJot is a Markdown notepad that opens instantly in your browser, with no account needed. Your notes are end-to-end encrypted.

Open the app Markdown cheat sheet