Match filenames
Use a relative reference such as , then select chart.png with the image picker. Nested paths can resolve by an unambiguous filename, but duplicate selected filenames should be renamed.
Use PNG or JPEG
PNG is suitable for diagrams and screenshots; JPEG is suitable for photographs. SVG and HTML are not accepted as image inputs in this version. Pre-render those to a local supported image.
Avoid remote tracking
The converter does not fetch web image URLs. This prevents an embedded image reference from disclosing that your document was opened or processed to a remote host.
Match image references deliberately
Place a PNG or JPEG beside your Markdown source and refer to it by its local filename, for example . Select the Markdown and the matching image in the workbench, then convert. The image bytes are embedded in the DOCX so a reader does not need access to your original folder or an external image server.
Check spelling, capitalization and extensions when an image is reported missing. A link to assembly.jpg does not name assembly.png, and an image visible in a Markdown editor may actually have been fetched from a web address. This workbench rejects external URLs and parent-directory references instead of silently fetching remote content or exporting a document with a missing illustration.
The supported image set is bounded: up to 30 local PNG/JPEG files, 10 MiB per file and 40 MiB combined, with a pixel limit as well. A highly compressed image can still have large dimensions. Resize an oversized source deliberately in an image editor, keeping enough detail for its intended page size, before retrying the conversion.
Alternative text provides context but does not repair an unreadable image. Open the DOCX and inspect labels at the expected viewing or printing size. Mermaid and other diagram fences remain code in this workflow; export a finished diagram to PNG or JPEG and attach it locally when you need the rendered illustration in the Word document.