简体中文

DocuCraftBox FAQ 与知识库

按分类提供 36 条答案,覆盖 Markdown 输入、高级元素、专业 Word 模板、可编辑 DOCX 输出、安全与故障排查。

开始使用

了解工具用途、输入方式、输出范围、使用门槛和通常处理时间。

DocuCraftBox 是什么?

DocuCraftBox 是一个面向 AI 报告、学术写作、商业文档和技术文档的专业 Markdown 转 Word 工具。 转换结果是应用四套模板之一的可编辑 Word 文档,而不是把 Markdown 原样复制成普通文本。

可以把 ChatGPT 或 Claude 输出转成 Word 吗?

可以。粘贴 ChatGPT、Claude、Gemini、DeepSeek 或其他工具生成的 Markdown,选择 Word 模板后即可导出 DOCX。 为了获得更稳定的结果,建议让 AI 输出有效 Markdown、保持本地图片为相对路径,并在导出后检查异常宽表或超长公式。

需要登录吗?

不需要。第一版是免费工具,不包含登录、会员或支付功能。 文件大小和每日使用次数限制用于维持免费服务可用,同时无需创建用户账号。

可以通过哪些方式提供 Markdown?

可以把内容粘贴到编辑器、选择 UTF-8 编码的 .md 文件、把 .md 文件拖入上传区,或上传包含一个 Markdown 文件及本地资源的 ZIP。选择 .md 后,内容也会同步到编辑器,便于转换前检查。

当前版本导出什么文件?

转换器导出可编辑 DOCX。本页面暂不提供 HTML 和 PDF。

一次转换通常需要多长时间?

短小纯文本文档通常很快完成;图片、复杂公式、多个 Mermaid 图表、引文和长文档会花更长时间。请保持页面打开,查看总体进度,直到文件生成或页面显示错误。

Markdown 输入与语法

说明标题、列表、表格、图片、代码、上传方式及保留文档结构的 Markdown 规则。

支持哪些 Markdown 元素?

支持 H1-H6、文本格式、链接、列表、任务列表、定义列表、嵌套引用、可编辑表格、图片、媒体链接、数学公式、Mermaid、代码、脚注、引文、交叉引用、分页、题注、索引、术语表和文档章节。 只要 Word 支持编辑,标题、表格、列表、脚注和公式就会保留为真正的文档内容,而不是截图。

表格可以包含合并单元格或多段内容吗?

可以,但要使用支持的 Markdown 表格写法。需要合并行列或在单元格中写多段内容时,请使用网格表格;普通数据使用管道表格最简单。 Markdown 中写明的对齐和列宽会优先使用;未指定时,模板会提供合适的对齐、边框、表头、间距和宽表处理。

可以和 Markdown 一起上传图片吗?

可以。当 Markdown 引用本地图片资源时,可以使用 ZIP 包。API 会在转换前检查文件大小和 ZIP 安全。 ZIP 解压前会检查大小、危险路径、文件数量、异常压缩和不支持的内容。

标题和已有编号应该怎么写?

使用 # 到 ###### 表示 H1-H6。启用标题自动编号时,应去掉标题中手写的“1.”或“2.3”等前缀,避免重复编号;必须保留手写编号时,请在本次转换中关闭标题自动编号。

支持哪些 Markdown 表格语法?

支持 Pandoc 管道表格、简单表格、多行表格和网格表格。需要多段落单元格或跨行跨列时,应使用 Markdown 原生的网格表格。语法中提供的对齐和宽度会被保留,否则由模板应用专业默认值。

代码块可以包含语言、文件名和行号吗?

可以。围栏代码块可携带语言类名,并通过支持的属性提供文件名和行号。Diff、终端、日志、命令、API、配置和文件树块会在技术文档模板中获得专用样式。

高级文档元素

覆盖公式、Mermaid、引文、交叉引用、提示块、报告组件和页面结构。

可以使用哪些报告和技术组件?

可以使用提示块、执行摘要、文档信息、API 说明、命令、配置、文件树、KPI 表、时间线、风险矩阵、SWOT 分析、优缺点、引文、参考文献和决策记录。 所选模板会决定这些组件的间距、边框、字体和文字反差。

支持 Mermaid 图表吗?

支持。Mermaid 代码会转换成图片并插入 Word,还可以添加图题。如果语法错误,或图表依赖不安全的外部内容,页面会提示错误,不会生成残缺图表。 图表会在插入前进行检查。语法错误、不安全标记或无法访问的外部内容会触发错误,不会生成错误图片。

支持复杂数学公式吗?

支持。除行内和块级公式外,还支持矩阵、行列式、分段函数、对齐方程、数组、多重积分、极限、求和、连乘、嵌套根式、重音、自定义宏、公式编号、题注和交叉引用。超长公式建议在实际使用的 Word 编辑器中再检查一次。 公式标签和题注可以生成编号与引用。Word 与 WPS 对超长公式的换行可能不同,分享前请检查最终版式。

引文和参考文献可以导出吗?

可以。使用 [@key] 引文,并提供 BibTeX 或 CSL JSON 文件,即可按 APA、MLA 或 GB/T 7714 排版;同时也支持标准 Markdown 脚注和参考文献区。 引文数据会转换成排版后的引文和可编辑参考文献表,不会把原始引用键留在文档中。

图、表和公式可以交叉引用吗?

可以。带标识的图表可使用 #fig: / #tbl: 与 @fig: / @tbl: 引用;公式支持标签和引用。题注会本地化为英文 Figure/Table 或中文“图/表”,并保留用户自定义题注。 需要引用图、表或公式时,请为它们添加标识。自动题注和自定义题注会共用一套连续编号。

提示块可以使用哪些标签?

可以使用 NOTE、TIP、WARNING、IMPORTANT、CAUTION、INFO、SUCCESS 或 ERROR,也支持已识别的中文标签和多行内容;颜色与间距由所选模板决定。

模板与文档设计

说明四套 Word 模板如何形成真实结构差异,而不只是更换颜色。

应该选择哪个模板?

日常文档选择简洁办公;公式和参考文献选择学术论文;KPI 和分析报告选择商业报告;API、代码、文件树、配置块、命令和图表选择技术文档。 四套模板还会使用不同的字体、段落间距、标题分页、页眉页脚、题注、表格、提示块、代码样式和封面内容。

可以创建封面、页眉页脚、页码或横向章节吗?

可以。YAML 元数据可提供标题、副标题、作者、日期、摘要和关键词等封面字段;模板提供页眉、页脚和页码;支持的围栏 Div 可创建横向、多栏、附录、签名和审批章节。 水印是可选功能,默认关闭。分页和分节会使用 Word 的页面结构,不会靠增加空行模拟。

为什么要使用模板,而不是普通转换?

模板会控制标题层级、字体、间距、表格、题注、代码、页眉页脚和页面版式,减少普通转换后还要手动排版的工作。 Markdown 源文件仍可重复使用,模板则提供办公审阅、学术提交、客户交付或技术交接所需的 Word 版式。

可以生成目录、图目录或表目录吗?

可以在转换器选项中启用 Word 目录。带标识和题注的图表可在所选模板及 Word 编辑器支持时参与图目录和表目录。打开 DOCX 后如编辑器提示,请更新域。

四个模板在结构上有什么区别?

简洁办公侧重会议纪要、清单、紧凑表格和克制间距;学术论文强化封面元数据、摘要、关键词、引文、脚注、公式和参考文献;商业报告突出执行摘要、KPI、风险、时间线和审批区;技术文档优先处理 API、代码、配置、文件树、图表和版本记录。

导出的文档还能在 Word 或 WPS 中编辑吗?

可以。标题、段落、列表、表格、脚注、公式、题注和大多数其他元素仍是可编辑 Word 结构。Mermaid 图表以图形嵌入,图表变更时应修改 Markdown 源码并重新转换。

Word 输出与编辑

说明题注、编号、页面布局、文件命名、兼容性,以及当前仅提供 DOCX 下载。

可以下载 PDF 吗?

当前版本不提供 PDF。转换器只下载 DOCX,便于在 Word 或 WPS 中继续编辑。等 PDF 版式能够稳定保持与 Word 一致后,再考虑开放下载。 暂不提供 PDF,是因为表格、字体、分页和图表还不能稳定保持与可编辑 DOCX 一致。

远程图片、视频和音频如何处理?

本地图片应使用相对路径并随 ZIP 一起上传。远程图片受部署安全与可用性规则约束。视频和音频链接会降级为带标签的文档链接或说明块,因为可编辑 Word 无法可靠复现网页播放器。

文档可以包含分页、分节或横向页面吗?

可以。受支持的 Markdown 标记和围栏 Div 类可创建分页、分节、横向章节、多栏章节、附录、签名区和审批区。这些会转换为 Word 结构,而不是用空白段落模拟。

本地化题注和自定义题注如何工作?

自动题注在英文中使用 Figure 和 Table,在中文中使用“图”和“表”。用户编写的题注文本会保留,稳定标识可用于引用。除非确实需要两个可见题注,否则不要在已有标识的图表旁再手写第二个题注。

上传和 ZIP 安全会执行哪些限制?

Markdown 和 ZIP 的文件大小会在上传前及转换服务器上分别检查。ZIP 还会检查不安全路径、文件数量过多、异常压缩、解压后体积过大、不支持的内容和存储空间不足。

为什么自动编号会和标题中的已有编号重复?

Word 自动编号与标题中手写的文本是两套内容,因此“## 2. 背景”在启用自动编号时可能显示两个编号。请删除手写编号或关闭标题自动编号;DocuCraftBox 不会猜测每个数字前缀是否属于正文。

安全与故障排查

说明临时文件、上传限制、ZIP 安全、转换失败原因和处理方法。

转换在哪里完成?

网站会把内容发送到单独的转换服务,由它生成 DOCX 并在之后清理临时文件。转换程序不会直接在公开的 WordPress 站点中运行。 转换密钥保存在服务器上,不会写入公开的转换页面。

上传文件会保留多久?

文件仅临时保留。完成的转换默认最多保留 60 分钟;下载后通常约 10 分钟清理;失败的转换约 30 分钟后清理。服务器配置可能缩短这些时间。 保留时间可能因服务器设置而不同。请及时下载重要结果,过期的转换无法恢复。

为什么转换会失败或过期?

常见原因包括文件过大、ZIP 内容不受支持或不安全、公式或图表语法错误、服务暂时不可用,或生成后等待太久才下载。 页面会显示可读的错误提示。Markdown 或 ZIP 内容有误时,请修正后重试;连接或服务器错误可能需要管理员处理。

下载文件如何命名?

转换器会优先使用文档标题或第一个有效标题作为文件名,移除文件名不能使用的字符,并添加 DOCX 扩展名。找不到标题时,会生成一个不重复的备用文件名。

转换密钥会暴露在浏览器中吗?

不会。转换密钥保存在网站服务器上,不会写入转换页面或浏览器 JavaScript。

进度看起来卡住时应该怎么办?

不要重复提交同一文档,请保持页面打开并稍等。如果出现错误或过期提示,请按照提示修正 Markdown 或上传文件后重新开始;如果页面提示网络或服务连接问题,请联系站点管理员。