Conversion steps
- Input — Markdown text, .md/.markdown, or a validated ZIP package.
- File checks — The service checks the file type and size. ZIP packages are also checked for unsafe paths, unsupported contents, and excessive extracted size.
- Temporary workspace — Each conversion uses its own temporary folder so files from different visitors are not mixed together.
- Create the document — The service reads the Markdown, prepares diagrams and formulas, applies the selected template, and creates the DOCX.
- Download and cleanup — When the file is ready, download it from the converter. Temporary files are removed automatically after the retention period.
Supported scope
The current support matrix covers headings, lists, tables, images, formulas, Mermaid, code, callouts, footnotes, citations, references, page breaks, captions, and professional report blocks.
How we test
Before release, automated tests cover service availability, file limits, ZIP safety, conversion status, cleanup, DOCX downloads, templates, formulas, diagrams, tables, notes, and error messages. A full sample document also checks Chinese and English text, images, code, footnotes, citations, and page breaks.
| Area | Current evidence |
|---|---|
| Conversion service and DOCX output | Covered by automated tests for creation, status, download, limits, and cleanup. |
| Windows and DOCX review | Generated documents are reviewed during local development. |
| Chrome / Edge / Firefox | Manual release checks are required; results must be recorded before claiming full compatibility. |
| macOS | No completed repository test record yet; listed as a manual production check. |
Known limitations
Mermaid diagrams that depend on unsafe HTML or external resources cannot be converted. Very wide tables, uncommon fonts, complex LaTeX, remote images, and unusual citation data may need manual adjustment in Word or WPS. The current public converter exports DOCX only.
Maintenance and updates
Changes that affect conversion results or the interface are tested with sample documents and recorded in the changelog. Browser and platform compatibility is updated after it has been checked.