什么是 WordToMD？

我们的使命

WordToMD 的存在是为了解决一个特定的、常见的问题：将内容从 Word 文档中提取到 Markdown 中，而无需手动进行格式化工作。无论您是编写文档的开发人员、维护博客的作家，还是迁移知识库的组织，Word 到 Markdown 的转换步骤都不会很痛苦。

工作原理

WordToMD 由两个优秀的开源库提供支持：

• mammoth.js — 通过 FileReader API 在浏览器中读取 .docx 文件并将其转换为干净的 HTML，将 Word 样式（标题 1、标题 2 等）映射到其 HTML 等效项。
• turndown — 将 mammoth 的 HTML 输出转换为标准 Markdown，并具有表格（GitHub Flavored Markdown）、代码块和其他元素的自定义规则。

整个管道在浏览器选项卡内运行。使用以下命令读取文件 FileReader API，从不通过网络传输。

隐私第一

许多文档转换工具要求您将文件上传到服务器。这意味着您的内容（可能是机密报告、客户文档、内部知识库文章）会通过其他人的基础设施。

WordToMD 在架构上有所不同：转换逻辑在浏览器选项卡中的 JavaScript 中运行。文件字节永远不会离开您的设备。您可以在转换之前打开浏览器的“网络”选项卡 (F12) 来验证这一点 - 您将看到零文件上传请求。

保留的内容

以下 Word 元素可以可靠地转换：

• 标题 (H1–H6) → ATX 样式 Markdown 标题
• 粗体（**文本**) 和斜体 (_文本_) 格式化
• 有序和无序列表，包括嵌套列表
• 表格 → GitHub 风格的 Markdown 表格语法
• 带有锚文本的超链接
• 等宽字体/代码样式文本
• 所有 Unicode 字符（中文、日文、阿拉伯文、表情符号等）

已知限制

某些 Word 功能没有 Markdown 等效功能：

• 合并的表格单元格被简化为相邻列
• 当您选择 Markdown + 图像 ZIP 下载时，嵌入式图像将导出到图像文件夹中
• 不支持文本框和 SmartArt
• 自定义段落样式映射到最接近的标准等效样式
• 轨道更改/注释被删除（仅转换最终内容）

当 mammoth 检测到它无法完全转换的元素时，结果视图中的“转换注释”面板将列出它们，以便您可以手动查看。