A trail note needs a small map that can open a detailed version. Put trail-small.png and trail-full.png in a maps folder alongside the Markdown file.

Put the image inside the link

Enter this in Markdown source view.

[![Open full-size trail map](maps/trail-small.png)](maps/trail-full.png)

The first path supplies the preview. The second is the destination. Because the image is the link’s content, its alternative text describes the action and the destination. Give essential route instructions in text too.

The Markdown uses one relative path for the thumbnail and one for the link destination.

Illustrated two-path example. Keep both PNGs alongside the Markdown note in the maps folder.

Open the delivery copy in its intended viewer

Copy the note and its maps folder together. Open the copied note and confirm the small image appears, then use the viewer’s link-opening action and check the full-size map. If either fails, inspect its relative path and capitalization. If the viewer does not offer a clickable thumbnail, add a visible text link to the full-size file.

The copied note shows the small map and the link opens the larger map in the intended viewer.

Illustrated delivery test. Verify the image and the link separately.

W3C’s guidance for functional image alternatives