.
Basic Image Syntax
!A cat sitting on a keyboard
The ! tells markdown this is an image. The [ ] contains the alt text. The ( ) contains the image URL.
Alt Text Matters
Alt text serves two purposes: it's read by screen readers for accessibility, and it appears when the image fails to load. Write descriptive alt text — not just "image" or "photo".
Bad: 
Good: 
Adding a Title
Add a quoted title after the URL:
The title appears as a tooltip when hovering over the image.
Clickable Image (Image Link)
To make an image clickable, nest the image inside a link:
[](https://example.com)
This is the standard pattern for badge images in README files.
Local vs Remote Images
Markdown supports both remote URLs (https://...) and relative paths (./images/photo.jpg). Relative paths work when the markdown file and image are in the same repository or directory.
Image Sizing
Standard markdown has no native sizing syntax. Options:
- Use HTML:
- Some platforms (Obsidian) support
with a width hint
Full reference: Markdown Images.