When writing file paths using:

<Image url="@../xxxx"/>
<Media source="@yyyy"/>
<fx:include source="zzzzz"/>

all paths should be encoded as URIs.

In other words, for a file named "My File" the FXML should contain "My%20File"