Accepted input
Paste Markdown, upload a .md file, or upload a ZIP package containing Markdown and relative image assets. Use standard Markdown where possible for the most predictable output.
Editable DOCX export
Convert Markdown to Word
Free Markdown to Word converter for editable DOCX with H1-H6, complex tables and math, Mermaid, images, code, citations, cross-references, and professional templates.
4 professional templates
Editable tables and captions
Mermaid diagrams
Before you convert
Input, output, and compatibility at a glance
Editable DOCX
The current output is .docx. Text, headings, lists, and tables remain editable; ordinary images and Mermaid diagrams are inserted as pictures.
Review before delivery
Review unusually long formulas, wide or nested tables, complex diagrams, page breaks, and fonts in the Word or WPS version used by the recipient.
Supported content
Convert Markdown, AI drafts, tables, formulas, diagrams, images, and code into Word
Use the sections below to check the supported Markdown syntax, Word result, and any limitations before converting a document.
AI content to Word
Convert ChatGPT and AI Content to Word
Paste Markdown from ChatGPT, Claude, Gemini, DeepSeek, or another AI writing tool, choose a Word template, check tables, formulas, code, and diagrams, then export an editable DOCX.
- AI tables may need valid Markdown table syntax.
- Mermaid code must be valid and produce safe standalone SVG without external resources.
- Local images should be uploaded in a ZIP package with the Markdown file.
Editable tables
Convert Markdown Tables into Editable Word Tables
Pipe, simple, multiline, and grid tables become editable Word tables rather than screenshots. Alignment, column widths, merged cells written in grid tables, headers, captions, numeric columns, borders, and wide tables are handled during conversion.
| Metric | Current | Target |
| --- | ---: | ---: |
| Conversion rate | 12% | 18% |
| Processing time | 8 min | 3 min |Math formulas
Convert Markdown Math Formulas to Word
Inline and display math supports matrices, determinants, cases, aligned equations, arrays, integrals, limits, sums, products, nested radicals, accents, safe custom macros, numbering, captions, and cross-references. Long or highly specialized LaTeX should still be reviewed in the target Word editor.
Inline formula: $E = mc^2$
Block formula:
$$
\int_a^b f(x)\,dx
$$Mermaid diagrams
Convert Mermaid Diagrams to Word
Mermaid code is converted into a diagram and inserted into Word with an optional figure caption. The diagram keeps its proportions and is scaled to fit the page. Invalid syntax or unsafe external content produces a clear error.
```mermaid
flowchart LR
A[Markdown] --> B[DocuCraftBox]
B --> C[Word DOCX]
```Images and ZIP packages
Convert Markdown with Images to Word
For local image assets, upload a ZIP package that keeps the Markdown file and image folder together. Relative paths are safer than remote image URLs, and file size limits still apply.
document.md
images/
diagram-01.png
screenshot-01.webpCode and technical docs
Convert Markdown Code Blocks to Word
Code fences can carry language labels, filenames, and line numbers. API, command, config, file-tree, diff, log, terminal, and console blocks receive dedicated technical-document styles.
```yaml
retentionMinutes: 60
cleanupIntervalMinutes: 10
```
```bash
npm run test
```Long-document structure
Add a Cover, Contents, and Page Layout
YAML at the top of the Markdown can provide the title, subtitle, author, date, abstract, and keywords. You can also use H1-H6, a table of contents, figure and table lists, indexes, glossaries, page breaks, landscape pages, columns, appendices, signatures, approvals, headers, footers, and page numbers.
---
title: Project Report
author: Example Team
abstract: Delivery summary
keywords: [report, DOCX]
cover: true
---Citations and cross-references
Create Citation-Aware Word Documents
Use [@key] citations with BibTeX or CSL JSON to format references in APA, MLA, or GB/T 7714 style. Figures, tables, and equations can also have identifiers, Chinese or English captions, custom caption text, numbering, and cross-references.
Research result [@smith2026].
{#fig:architecture}
See @fig:architecture.DOCX output
Editable DOCX Output
The converter creates a .docx file. Text, headings, lists, and tables remain editable; ordinary images and Mermaid diagrams are inserted as pictures. Word or WPS may ask you to refresh the table of contents after opening the file.
- Output format: .docx
- Templates control headings, spacing, captions, tables, and code blocks.
- PDF export is intentionally not part of the first version.
Support matrix
What DocuCraftBox currently supports
The table shows what each Markdown element becomes in Word and where manual review may still be needed.
| Markdown element | Supported | Word output | Notes |
|---|---|---|---|
| Headings | Yes | Native Word headings | H1-H6 |
| Rich text and lists | Yes | Editable structured text | Emphasis, links, highlight, super/subscript, keyboard keys, definitions, nested quotes, and multilevel lists. |
| Tables | Yes | Editable Word tables | Pipe, simple, multiline, grid tables, spans, captions, widths, and numeric alignment. |
| Formulas | Yes | Word math with numbering | Matrices, cases, aligned equations, arrays, integrals, macros, captions, and references. |
| Mermaid | Yes | Embedded diagram image | Keeps its proportions; invalid syntax and unsafe external content are rejected. |
| Images | Yes | Embedded image | ZIP is recommended for local assets. |
| Code blocks | Yes | Styled text block | Colors and syntax highlighting depend on the selected template and Word editor. |
| Footnotes | Yes | Word footnotes | Use standard Markdown footnote syntax. |
| Citations and references | Yes | Citations and bibliography | [@key], BibTeX, CSL JSON, APA, MLA, and GB/T 7714. |
| Table of contents | Yes | Word TOC | May require refresh in Word or WPS. |
| Generated lists and references | Yes | Figure/table lists, index, glossary | Includes acronyms and figure/table/equation cross-references. |
| Callouts | Yes | Styled note blocks | NOTE, TIP, WARNING, IMPORTANT, and similar blocks. |
| Page breaks | Yes | Native page break | Use supported pagebreak markers. |
| Cover and document information | Yes | Cover content for each template | Title, subtitle, author, date, abstract, keywords, and cover. |
| Sections and page layout | Yes | Native Word sections | Landscape, columns, appendices, signatures, approvals, headers, footers, and page numbers. |
| Technical code sections | Yes | Dedicated Word styles | Filename, language, line numbers, diff, log, terminal, API, config, and file tree. |
Quality standard
What remains editable and what to review
DocuCraftBox keeps supported content editable in Word whenever possible. Fonts, page breaks, and spacing can still vary between Word, WPS, operating systems, and installed fonts.
What stays editable
Headings, paragraphs, lists, tables, footnotes, citations, references, and most formulas remain editable Word content. Mermaid diagrams and ordinary images are embedded as pictures.
What happens to uploaded files
File size and ZIP contents are checked before conversion. Files are used only for the conversion, stored separately from other uploads, and removed automatically after the retention period.
What to check before delivery
Check facts, citations, long formulas, wide or nested tables, page breaks, diagram labels, image permissions, and the final appearance in the Word or WPS version used by the recipient.
Supported document elements
More than basic Markdown to Word
See which headings, tables, formulas, diagrams, references, code, and page-layout features can be written into the Word document.
Complete text hierarchy
H1-H6, paragraphs, emphasis, links, highlight, superscript, subscript, keyboard keys, definition lists, nested quotes, and multilevel lists remain structured.
TOC, generated lists, and navigation
Create a table of contents, page breaks, numbered headings, figure and table lists, an index, glossary, acronym list, appendices, and cross-references.
Professional editable tables
Pipe, simple, multiline, and grid tables become native Word tables with captions, spans, header styling, numeric alignment, widths, and wide-table handling.
Images, media, and captions
Control image size, alignment, floating, and text wrapping; add localized captions and cross-references. Video and audio links degrade to labelled document links.
Math formulas
Inline and display math support matrices, cases, aligned equations, integrals, limits, sums, products, custom macros, numbering, captions, and equation references.
Mermaid diagrams
Mermaid code is converted into a proportionally sized diagram and can include a localized caption and cross-reference.
Code and technical output
Code can include language labels, filenames, and line numbers. Diff, log, terminal, command, API, config, and file-tree blocks use their own Word styles.
Callouts and notes
NOTE, TIP, WARNING, IMPORTANT, CAUTION, INFO, SUCCESS, and ERROR callouts become readable Word note blocks.
Business analysis blocks
Executive summaries, KPI tables, timelines, risk matrices, SWOT analysis, pros and cons, and decision records are supported.
Citations and references
Footnotes, [@key] citations, BibTeX, CSL JSON, quote blocks, and bibliographies can use APA, MLA, or GB/T 7714 formatting.
Cover and front matter
YAML metadata can create title, subtitle, author, date, abstract, keywords, and a cover structure suited to each Word template.
Professional page layout
Headers, footers, page numbers, optional watermarking, section breaks, landscape pages, two- or three-column sections, and orphan control support long documents.
Delivery and approval sections
Appendices, signatures, approvals, metadata, executive summaries, abstracts, and decision records turn drafts into review-ready deliverables.
Workflow
Four steps from Markdown to Word
Add your content, choose a template, start the conversion, and download a Word document you can continue editing.
1
Paste or upload Markdown
Paste content from an AI tool or editor, choose a .md file, or upload a ZIP with local images.
2
Choose a Word template
Choose Clean Office, Academic, Business Report, or Technical Documentation according to the type of document.
3
Convert and format the document
DocuCraftBox formats headings, tables, formulas, diagrams, captions, notes, and code according to your selected options.
4
Download and continue editing
Open the DOCX in Word or WPS to review, revise, and share it.
Feature comparison
Basic converter vs DocuCraftBox
Compare the Word features available after conversion, including templates, formulas, citations, page layout, and editable tables.
| Feature | Basic converter | DocuCraftBox |
|---|---|---|
| Professional Word templates | Basic style only | Clean Office, Academic, Business, Technical |
| Long-document structure | Usually manual | TOC, numbered headings, page breaks, metadata, appendix |
| Tables and captions | Plain tables | Editable Word tables, borders, alignment, figure/table captions |
| Academic writing | Limited support | Formulas, footnotes, quotes, references, long-form hierarchy |
| Business report blocks | Usually unsupported | Executive summary, KPI, timeline, risk matrix, SWOT, decisions |
| Technical documentation blocks | Plain code only | API, command, config, file tree, code, Mermaid diagrams |
| Document navigation | Headings only | TOC, figure/table lists, index, glossary, acronyms, and cross-references |
| Page and section layout | One continuous layout | Cover, headers, footers, page numbers, landscape pages, columns, appendices, signatures |
| Citations and references | Plain reference text | [@key], BibTeX/CSL JSON, APA, MLA, and GB/T 7714 |
| AI content cleanup | Keeps rough Markdown shape | Turns AI drafts into scenario-based Word documents |
| File handling | Often unclear | Temporary storage, separate work folders, and automatic cleanup |
| Upload safety | Often missing | File-size limits, ZIP safety checks, and available-space checks |
Supported features
More ways to use the converter
Open the converter at the section for AI drafts, formulas, Mermaid diagrams, tables, images, code, or Word templates.
FAQ
Questions people ask before converting
See what the converter supports, how templates affect the result, how files are handled, and what to check before downloading.
Which Markdown elements are supported?
Supported content includes H1-H6, text formatting, links, lists, task lists, definition lists, nested quotes, editable tables, images, media links, math, Mermaid, code, footnotes, citations, cross-references, page breaks, captions, indexes, glossaries, and document sections. Where Word supports editing, headings, tables, lists, footnotes, and formulas remain real document content instead of screenshots.
Can I convert ChatGPT or Claude output to Word?
Yes. Paste AI-generated Markdown from ChatGPT, Claude, Gemini, DeepSeek, or other tools, then choose a Word template and export DOCX. For the most reliable result, ask the AI to return valid Markdown, keep local image paths relative, and review unusually wide tables or long formulas after export.
Does it support Mermaid diagrams?
Yes. Mermaid code is converted into an image and inserted into Word, with an optional figure caption. If the syntax is invalid or the diagram uses unsafe external content, the page shows an error instead of creating an incomplete diagram. Diagrams are checked before insertion. Invalid syntax, unsafe markup, or unavailable external content produces an error instead of an incorrect image.
Does it support complex math formulas?
Yes. In addition to inline and display math, it supports matrices, determinants, cases, aligned equations, arrays, multiple integrals, limits, sums, products, nested radicals, accents, custom macros, equation numbering, captions, and cross-references. Review unusually long formulas in the Word editor you plan to use. Equation labels and captions can generate numbering and references. Because Word and WPS can wrap very long formulas differently, check the final layout before sharing.
Can tables contain merged cells or multiple paragraphs?
Yes, when the table is written with supported Markdown syntax. Use a grid table for merged rows or columns and for cells containing multiple paragraphs. Pipe tables remain the simplest choice for ordinary data. Your Markdown alignment and column widths are used when provided. Otherwise, the template supplies sensible alignment, borders, headers, spacing, and wide-table handling.
Can I create a cover, headers, page numbers, or landscape sections?
Yes. YAML metadata supplies cover fields such as title, subtitle, author, date, abstract, and keywords. Templates provide headers, footers, and page numbers; supported fenced Divs create landscape, multicolumn, appendix, signature, and approval sections. Watermarks are optional and disabled by default. Page and section changes use Word layout features rather than extra blank lines.
Can figures, tables, and equations be cross-referenced?
Yes. Identified figures and tables use #fig: / #tbl: with @fig: / @tbl: references. Equations support labels and references. Captions are localized as Figure/Table in English and 图/表 in Chinese, and custom caption text is preserved. Use identifiers for figures, tables, and equations when you need references. Automatic and custom captions share one numbering sequence.
How long are uploaded files retained?
Files are temporary. Completed conversions are kept for up to 60 minutes by default, downloaded files are normally removed after about 10 minutes, and failed conversions after about 30 minutes. These times may be shortened by the server configuration. Retention times can vary by server settings. Download important results promptly because an expired conversion cannot be restored.
Can I upload images with Markdown?
Yes. Use a ZIP package when the Markdown references local image assets. The API checks file size and ZIP safety before conversion. ZIP packages are checked for size, unsafe paths, excessive file counts, abnormal compression, and unsupported contents before extraction.