DocuCraftBox FAQ and Knowledge Base
Thirty-six categorized answers about Markdown input, advanced elements, professional Word templates, editable DOCX output, security, and troubleshooting.
Getting started
What the tool does, accepted inputs, output scope, access, and typical processing time.
What is DocuCraftBox?
DocuCraftBox is a professional Markdown to Word tool for AI reports, academic writing, business documents, and technical documentation. The result is an editable Word document with one of four templates, rather than a plain text copy of the Markdown.
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.
Is login required?
No. The first version is a free tool without login, membership, or payment features. File-size and daily-use limits help keep the free service available without requiring user accounts.
How can I provide Markdown to the converter?
Paste content into the editor, choose a UTF-8 .md file, drag a .md file into the upload area, or upload a ZIP that contains one Markdown file and its local assets. The selected .md content is also loaded into the editor so it can be reviewed before conversion.
What file does the current version export?
The converter exports an editable DOCX file. HTML and PDF are not included in this page.
How long does a conversion normally take?
Short text-only documents usually finish quickly. Images, complex math, multiple Mermaid diagrams, citations, and long documents take longer. Keep the page open and watch the overall progress until the file is ready or an error message appears.
Markdown input and syntax
Headings, lists, tables, images, code, uploads, and the Markdown rules that preserve structure.
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 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 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.
How should headings and existing numbers be written?
Use # through ###### for H1-H6. If automatic heading numbering is enabled, omit typed prefixes such as "1." or "2.3" to avoid duplicate numbers. If authored numbering must be preserved, disable automatic heading numbering for that conversion.
Which Markdown table syntaxes are supported?
Pandoc pipe, simple, multiline, and grid tables are supported. Grid tables are the Markdown-native option for multi-paragraph cells and row or column spans. Alignment and authored widths are retained when the syntax provides them; otherwise the template applies professional defaults.
Can code blocks include a language, filename, and line numbers?
Yes. Fenced code blocks can carry language classes and supported attributes for filenames and line numbering. Diff, terminal, log, command, API, config, and file-tree blocks receive specialized formatting in the technical template.
Advanced document elements
Math, Mermaid, citations, cross-references, callouts, report sections, and page structure.
Which report and technical sections can I use?
You can use callouts, executive summaries, document information, API sections, commands, configuration, file trees, KPI tables, timelines, risk matrices, SWOT analysis, pros and cons, citations, references, and decision records. The selected template controls the spacing, borders, fonts, and text contrast used for these sections.
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 citations and references be exported?
Yes. Use [@key] citations with a BibTeX or CSL JSON file. APA, MLA, and GB/T 7714 styles are available, and standard Markdown footnotes and reference sections are also supported. Citation data is turned into formatted citations and an editable bibliography instead of leaving raw citation keys in the document.
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.
Which callout labels can I use?
Use NOTE, TIP, WARNING, IMPORTANT, CAUTION, INFO, SUCCESS, or ERROR. Recognized Chinese labels and multi-line content are also supported, and the selected template supplies the colors and spacing.
Templates and document design
How the four Word templates differ and how they control real document structure, not only color.
Which template should I choose?
Use Clean Office for everyday docs, Academic for formulas and references, Business Report for KPI and analysis, and Technical Documentation for API docs, code, file trees, config blocks, commands, and diagrams. The four templates also use different fonts, paragraph spacing, heading pagination, headers, footers, captions, tables, notes, code styles, and cover content.
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.
Why use templates instead of plain conversion?
A template controls heading levels, fonts, spacing, tables, captions, code, headers, footers, and page layout. This saves the manual formatting normally needed after a basic conversion. The Markdown source remains reusable, while the template supplies the Word layout needed for office review, academic submission, client delivery, or technical handoff.
Can I generate a table of contents, list of figures, or list of tables?
A Word table of contents can be enabled from the converter options. Identified and captioned figures and tables can participate in figure and table lists when the selected template and Word editor support those fields. Update fields after opening the DOCX if the editor requests it.
How are the four templates structurally different?
Clean Office favors meeting notes, checklists, compact tables, and restrained spacing. Academic adds cover metadata, abstracts, keywords, citations, footnotes, equations, and bibliography treatment. Business Report emphasizes executive summaries, KPI, risk, timelines, and approval areas. Technical Documentation prioritizes API, code, config, file trees, diagrams, and version records.
Can the exported document still be edited in Word or WPS?
Yes. Headings, paragraphs, lists, tables, footnotes, equations, captions, and most other elements remain editable Word structures. Mermaid diagrams are embedded graphics, so their source should be edited in Markdown and converted again when the diagram changes.
Word output and editing
Captions, numbering, page layout, file naming, compatibility, and the current DOCX-only output.
Can I download PDF too?
Not in the current version. The converter provides DOCX so the result remains editable in Word or WPS. PDF download may be added after its layout matches the Word document reliably. PDF is not offered yet because its tables, fonts, page breaks, and diagrams may not match the editable DOCX reliably.
How are remote images, video, and audio handled?
Local images should be packaged in ZIP with relative paths. Remote images are subject to deployment security and availability rules. Video and audio links are represented as labeled document links or fallback blocks because an editable Word file cannot reproduce a web media player reliably.
Can the document include page breaks, sections, or landscape pages?
Yes. Supported Markdown markers and fenced Div classes can create page breaks, section breaks, landscape sections, multicolumn sections, appendices, signatures, and approvals. These become Word structures rather than simulated blank paragraphs.
How do localized and custom captions work?
Generated captions use Figure and Table in English and 图 and 表 in Chinese. Authored caption text is preserved, and stable identifiers allow references. Do not write a second manual caption beside an identified figure or table unless two visible captions are intended.
What upload and ZIP safety limits are enforced?
Markdown and ZIP file sizes are checked before upload and again on the conversion server. ZIP packages are also checked for unsafe paths, too many files, unusual compression, excessive extracted size, unsupported contents, and insufficient storage space.
Why can automatic numbering duplicate numbers already in my headings?
Word automatic numbering and text typed into a heading are separate. A heading written as "## 2. Background" can therefore display two numbers when numbering is enabled. Remove the typed number or disable automatic heading numbering; DocuCraftBox does not guess whether every numeric prefix is intentional content.
Security and troubleshooting
Temporary storage, upload limits, ZIP safety, failed conversions, and what to try next.
Where does the conversion happen?
The website sends the content to a separate conversion service, which creates the DOCX and removes temporary files afterward. The conversion tools do not run inside the public WordPress site. The conversion key stays on the server and is never included in the public converter page.
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.
Why did a conversion fail or expire?
Common causes include an oversized file, unsupported or unsafe ZIP contents, invalid formulas or diagrams, a temporary service problem, or waiting too long before downloading the result. The page shows a readable error message. Correct invalid Markdown or ZIP contents before retrying; connection and server errors may require an administrator.
How are downloaded files named?
The converter uses the document title or first meaningful heading when possible, removes characters that cannot be used in filenames, and adds the DOCX extension. If no title is available, it creates a unique fallback filename.
Is the conversion key exposed in the browser?
No. The key stays on the website server and is not included in the converter page or browser JavaScript.
What should I do if progress appears stuck?
Do not submit the same document repeatedly. Keep the page open for a little longer. If an error or expiration message appears, follow that message, correct the Markdown or uploaded files, and start again. If the page reports a network or service connection problem, contact the site administrator.
No matching answer was found. Try a shorter keyword or browse a category.