Markdown Images
Last updated: 2026-10-14
Images CommonMark core
Image syntax is link syntax with a leading !: . The alt text shows when the image fails and matters for accessibility and SEO — write it carefully.
| Group | Basic: Block |
|---|---|
| Spec level | CommonMark core |
| Spec version | CommonMark 0.31.2 + GFM |
📝 Syntax
▶ Live Example
Edit Markdown on the left, see the result on the right
💡 Key points
💡 Tip Hotlinked images can break; self-host anything important.
ℹ️ Note For this site, prefer root-relative /paths to dodge language-subfolder issues.
❓ FAQ
Q Can I control image size?
A Not in pure Markdown; use HTML <img width> or CSS.
Q Can an image link somewhere?
A Nest them: [](link).
Q What makes good alt text?
A Describe content and purpose briefly; decorative images use alt="".
📚 See also
LinksCommonMark core