Prepare the Word document
Use the modern .docx format. Old .doc files, macro-enabled files, encrypted packages, and damaged documents are not accepted by the current converter.
Open older Word files in Word or a compatible editor and save a clean .docx copy first.
PNG, JPEG, and GIF images can be copied as real files instead of flattened placeholders.
Convert essential SmartArt, charts, equations, or legacy drawing objects to images if exact appearance matters.
The generated Markdown is a working copy. Keep the source DOCX as the authoritative record.
Create one portable Markdown package
Choose the DOCX and run the browser-local converter. The same workflow extracts document structure, copies supported image bytes, creates relative paths, and writes the coverage report.
Headings, paragraphs, emphasis, links, lists, and simple tables are rebuilt as Markdown.
Supported images are copied into assets/ with stable names such as image-001.png.
The Markdown, optional assets folder, and conversion-report.json are downloaded together.
Check what moved and what still needs review
DOCX can contain several XML parts and embedded object types. The report separates tested output from content that needs a manual comparison.
| Area | Status | What the evidence shows |
|---|---|---|
| Headings, paragraphs, lists, links | Converted | Core structure is covered by integration fixtures and deterministic output checks. |
| PNG, JPEG, and GIF | Copied as assets | Original raster bytes retain source order and use portable relative paths. |
| Simple tables | Converted | A basic two-column, two-row fixture preserves its row and column relationship. |
| Equations, VML, charts, SmartArt | Review required | Detected unsupported objects are listed as warnings instead of being silently treated as complete. |
| Old, encrypted, macro, or damaged files | Not accepted | The converter stops before creating a misleading partial package. |
Use the package without breaking image paths
Extract the ZIP into one folder and keep its internal structure. Most Markdown tools can resolve assets/image-001.png when the Markdown file and assets folder remain siblings.
Copy the extracted folder into the vault, then confirm that attachment paths render as expected.
Commit the Markdown and assets directory together so relative image links remain valid.
Review warnings and decide how the destination system should handle image files before ingestion.