Primary navigation
English

DocuCraftBox FAQ and Knowledge Base

Thirty-six categorized answers about Markdown input, advanced elements, Word templates, DOCX, PDF, and standalone HTML output, security, and troubleshooting.

Getting started

What the tool does, accepted inputs, output scope, access, and typical processing time.

What is DocuCraftBox?

DocuCraftBox converts Markdown into Word DOCX, PDF, and HTML for AI reports, academic writing, business documents, and technical documentation. The result is an editable Word document or fixed-format PDF with one of four templates, rather than a plain text copy of the Markdown.

Can I convert ChatGPT or Claude output to Word DOCX, PDF, and HTML?

Yes. Paste AI-generated Markdown from ChatGPT, Claude, Gemini, DeepSeek, or other tools, then choose a workspace and template to export Word DOCX, PDF, and HTML. 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. You can still use the free converter without an account. Creating an account is optional for now and keeps your access connected to your account. File-size and daily-use limits help keep the free service available. An account is optional for now and does not create online document history.

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 DocuCraftBox export?

DocuCraftBox exports Word DOCX, PDF, and HTML, depending on the workspace you choose. For Word and PDF workspaces, the HTML preview is a visual reference; the HTML workspace downloads a standalone HTML file using the same preview snapshot and styles.

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 its 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 included in the selected DOCX, PDF, or standalone HTML output, 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. For complex diagrams, inspect the embedded image in the target DOCX editor or PDF viewer before delivery.

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 editor or PDF viewer 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. The selected DOCX template or PDF layout supplies headers, footers, page numbers, and page rules; 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?

The document navigation options can be enabled in the workspace. Identified and captioned figures and tables can participate in figure and table lists when the selected output and viewer support those fields. Update fields after opening a 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.

Output formats

Captions, numbering, page layout, file naming, compatibility, and the DOCX, PDF, and HTML output paths.

Can I download PDF too?

Yes. The PDF workspace creates a fixed-format PDF with its own page, font, table, formula, image, and template settings. Review the final PDF in your target viewer because pagination and font availability can vary. If you need a fixed-layout copy, choose the PDF workspace; if the recipient needs to edit, choose the DOCX workspace.

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 links or fallback blocks because DOCX, PDF, and standalone HTML have different media behavior and cannot reliably reproduce every web player.

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. DOCX uses document sections; PDF applies the corresponding page layout during rendering rather than simulating changes with 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 selected output from Word DOCX, PDF, and HTML 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. 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 matching DOCX or PDF 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.