转换步骤
- 输入 — Markdown 文本、.md/.markdown 文件或通过校验的 ZIP 包。
- 文件检查 — 系统会检查文件类型和大小；ZIP 还会检查危险路径、不支持的内容和过大的解压体积。
- 临时工作区 — 每次转换使用单独的临时目录，避免不同访客的文件混在一起。
- 生成文档 — 系统读取 Markdown，处理图表和公式，应用所选模板并生成 DOCX。
- 下载与清理 — 文件生成后可在转换器中下载；临时文件会在保留时间结束后自动清理。
支持范围
当前支持矩阵涵盖标题、列表、表格、图片、公式、Mermaid、代码、提示块、脚注、引用、参考文献、分页、题注和专业报告块。
如何测试
发布前会通过自动化测试检查服务可用性、文件限制、ZIP 安全、转换状态、自动清理、DOCX 下载、模板、公式、图表、表格、提示块和错误信息。完整示例还会检查中英文、图片、代码、脚注、引用和分页。
| 测试项 | 当前证据 |
|---|---|
| 转换服务与 DOCX 输出 | 通过自动化测试检查创建、状态、下载、限制和清理。 |
| Windows 与 DOCX 检查 | 本地开发期间会检查生成的文档。 |
| Chrome / Edge / Firefox | 发布前需要人工检查，并记录结果后才能声明完整兼容。 |
| macOS | 仓库尚无已完成测试记录，列为上线前人工检查项。 |
已知限制
依赖不安全 HTML 或外部资源的 Mermaid 图表无法转换。超宽表格、特殊字体、复杂 LaTeX、远程图片和特殊引用数据可能需要在 Word 或 WPS 中手动调整。当前公开转换器仅导出 DOCX。
维护与更新
影响转换结果或界面的改动会使用示例文档测试，并记录在更新日志中。浏览器和平台兼容情况会在检查后更新。