Spaces in Link Targets
%20 or wrap the URL in angle brackets.
Q-2-33 — Spaces in Link Targets
Link targets cannot contain spaces. Replace spaces with
%20, or wrap the target in angle brackets:[text](<my file.png>).
What this means
The URL portion of a link or image — the part inside (...) —
cannot contain literal spaces unless it is wrapped in angle
brackets (<...>). The standard URL-encoding for a space is %20;
an unencoded space terminates the URL prematurely and confuses the
parser.
Why this happens
Almost always a filename or path with a space character (common on macOS and Windows):
How to fix
Wrap the target in angle brackets (CommonMark syntax), which may contain spaces:
or replace each space with %20:
Both forms produce the same document.
Better still, rename the file so it has no spaces — for example
image-file.png or image_file.png. URL-encoding works, but
spaces in filenames cause friction in many other tools too.