TLDR: Don’t use shortcut references for Markdown link and image destinations. Use collapsed references instead. When adding links and images to your Markdown documents, you can choose from four different formats. Each has its own benefits, but some are better than others, especially for long-term …

Choosing the right format for Markdown links and images

jmooring Split this topic August 22, 2025, 3:46pm 3

Topic		Replies	Views
Link with ref, relref: Why not use markdown syntax? support	3	631	June 21, 2019
Shortcodes help needed support	3	1050	June 18, 2015
Listing links using a shortcode support	4	507	July 2, 2020
Shortcodes and numbers for reference-style link definitions support	3	934	June 14, 2019
Inline references not working support	2	851	March 24, 2015