Home → Markdown → Links & Images

Links & images in Markdown

Links use [text](url); images are the same with a leading !. Both support optional titles, and you can combine them to make an image a link.

Links

[Inline link](https://example.com)
[With a title](https://example.com "Shown on hover")
<https://example.com>  (autolink)

Inline link With a title https://example.com (autolink)

Reference-style links

Keep long URLs out of your prose by defining them once and referencing them by label:

[reference link][1]

[1]: https://example.com

reference link

Images & linked images

The text in the brackets is the alt text — always include it for accessibility and SEO.

![Alt text](https://example.com/cat.png)

[![Linked image](https://example.com/cat.png)](https://example.com)

Alt text

Linked image

Related: full cheat sheet · tables · code blocks.

Have a document instead of text?

Convert PDFs, Word, PowerPoint, Excel, and images into clean Markdown — free, no signup.

Convert a file to Markdown →