A Markdown editor may show pictures that disappear from a converted Word document. The converter may have the image reference without the image file. Changing headings or renaming the document does not supply those missing resources.
Separate text from image resources
Pandoc describes an exclamation mark before a link as image syntax. Consider this illustrative example:
The text names a location; it does not contain the whole picture. Pandoc's resource-path documentation explains that producing DOCX requires finding the image resources.
| Available item | What to verify |
|---|---|
| Markdown file | Text and referenced paths |
| Images folder | Actual files matching those references |
| Picture visible in an editor | Where that editor obtains it |
| Converted Word file | Pictures, captions and their sequence |
This is our source-review checklist, not a list of settings available on the conversion page.
FileMyLove's input boundary
Convert document passes the selected Markdown file's content to the conversion process. This flow does not take a companion image folder and resolve its paths. Do not expect pictures sitting beside the Markdown file on your computer to accompany it automatically. Moving pictures to a public website is not a promised workaround for this converter.
For a text-focused document, convert and inspect headings and paragraphs first, then insert the retained images manually in Word. For many pictures, consider a local conversion workflow that can access the full set of files and configure resource locations.
Review pictures and captions together
- Keep the Markdown source and original pictures together.
- Record the picture count and the section for each image.
- Open the converted DOCX in the application used for delivery.
- Insert missing pictures and match each caption correctly.
- Check dimensions, page breaks and references to figures before sending.
A visible caption does not establish that the picture is embedded. Successful conversion alone does not establish that every resource is present.
Diagnose the right part
For headings rendered as ordinary text, see Markdown to Word headings. For awkward tables, see Markdown table columns in Word. Review text structure and missing pictures separately, while retaining the source files.
