Turn a Markdown field report into an editable DOCX
Admin ·
A field report written in Markdown needs review in Word. Convert the checklist, measurements and code into familiar document structures that a reviewer can edit.
Convert the sample field report
Choose Load example. Keep GitHub-flavored tables and tasks enabled, then choose Convert to DOCX. Field report appears as the heading. The first numbered item is 3. Confirm the sign, with two nested tasks underneath.
Download markdown.docx and open it in your word processor. Check that the table is editable. Its two data rows show Zürich with 17 and 東京 with 24.
CommonMark specification, Markdown blocks and inlinesGitHub Flavored Markdown, tables and task lists
Check formatting in the word processor
The numbered entries use document numbering. The nested tasks carry [x] and [ ] text. Test the Field notes link and confirm it points to https://example.com/field-notes.
In the code block, confirm that next = review starts with two spaces. Word can substitute fonts for Unicode scripts. Change the font if your reader lacks a glyph.
CommonMark specification, Markdown blocks and inlinesECMA-376, WordprocessingML and packaging
Embed a local figure in the Word document
Download the sample image grid and select image-grid-sample.png under Local Markdown images. Append the example image line to the field report and convert again.
Open Embedded local images to compare the preview with the 301 × 203 px source. In the saved DOCX, check that the figure is a selectable image and that its alternative text reads Field diagram.
Download the 301 × 203 px summary gridCommonMark specification, Markdown blocks and inlinesECMA-376, WordprocessingML and packaging
Review images and links before sharing
The final filename in a relative path matches the selected attachment, including letter case. Use a different name for each file in the selection. An unmatched reference or external image URL keeps its alternative text in the Word document.
Absolute HTTP and HTTPS links and mailto addresses become editable links. Relative paths and fragment links keep their displayed text. Raw HTML appears as text and does not run in the preview.
Common questions
Can I upload a Markdown file instead of pasting it?
Yes. Use Local Markdown file to select a UTF-8 file. The downloaded DOCX uses the source filename with a .docx extension.
How do I keep my Markdown table columns?
Use GitHub-flavored tables and tasks and preview the conversion. The output uses native table rows and cells that word processors can edit.
Why is my attached JPEG stored as a PNG inside the DOCX?
The converter redraws attached images as PNG for the Word package and caps the long edge at 1,200 pixels. It applies the browser’s image orientation during conversion.