Word 转 Markdown

「Word 转 Markdown」把 .docx 文档转换成 Markdown 文本。选择文件后,页面会列出转换结果,你可以点击「复制」或「下载md」。它会把标题、加粗、斜体、删除线、列表、链接和表格转成对应的 Markdown 语法,字体、颜色等无法用 Markdown 表达的样式则不会保留。只支持 .docx 格式,旧版 .doc 需要先在 Word 里另存为 .docx。

操作步骤

1. 点击虚线框「点击选择 .docx 文件」,选中要转换的文件。
2. 页面显示「正在转换…」,完成后出现「转换结果」区域,以等宽字体显示 Markdown 文本。
3. 点击「复制」把结果放进剪贴板(成功后短暂显示「已复制」),或点击「下载md」保存文件。下载的文件名是原文件名加 .md。
4. 把内容粘贴到你的 Markdown 编辑器、笔记软件或文档仓库里,再按需要整理。

一个实际生成的例子

我们用同一套转换库和规则(先用 mammoth 转成 HTML,再用 turndown 转成 Markdown,这与工具的流程一致)处理了一份预先生成的 .docx 测试文档。文档内容是:一个一级标题「季度报告」、一个二级标题、一段含加粗、斜体和删除线的句子、一个两列两行的表格,以及一个结尾段落。得到的 Markdown 是:标题写成「# 季度报告」「## …」的井号形式;加粗写成两个星号包围的文字;斜体写成下划线包围的文字;删除线写成两个波浪线包围的文字;表格变成了竖线表格:表头行「| 姓名 | 分数 |」、分隔行「| --- | --- |」和数据行「| 小明 | 90 |」;项目符号列表每行以「*」加三个空格开头,编号列表以「1.」「2.」开头;图片默认仍然会变成「」形式,后面跟着很长的编码;取消勾选「包含图片」后,图片会被整个丢弃,只剩前后的文字(用一张 1×1 像素的测试图片验证:勾选时输出带 data 地址的图片语法,取消勾选时只剩「Hi」和「Bye」两段文字)。

支持范围与已知限制

• 只支持 .docx。选择旧版 .doc 或无效文件会提示「无法转换这份文件,请确认上传的是有效的 .docx 文件(不支持旧版 .doc 格式)。」
• 标题使用井号写法(「#」「##」等),一级、二级标题不再使用下划线写法。
• 表格会转成 Markdown 竖线表格,并固定把第一行当作表头;单元格内容会被压成一行纯文本,合并单元格、单元格内的列表和换行不会保留。
• 「包含图片」默认勾选:图片会被直接内嵌成 base64 编码的图片语法,内容很长,而且多数 Markdown 平台并不适合这样引用图片,通常需要另外导出图片并改成图片地址。取消勾选可去掉图片(不会留下占位符或替代文字),切换后会立即重新转换;图片本身不会被导出成单独文件。
• 下划线、字体颜色、字号、对齐方式等都不会保留;删除线会保留,写成 ~~文字~~。
• 加粗和斜体需要在 Word 里是真正的字符格式才会被识别;标题则取决于是否使用了内置的「标题 1」「标题 2」等样式,手动放大字号的普通段落不会被识别为标题。
• 列表项的缩进层级是否完整保留,取决于文档的列表结构,复杂的多级列表请在转换后自行核对。
• 没有提供转换选项,比如不能切换标题写法、列表符号或强调符号。

常见问题:粘贴到我的笔记软件后格式不对,是工具出错了吗?

不一定。不同的 Markdown 软件支持的语法略有差异,比如有的不支持带很长 base64 的图片(可以取消勾选「包含图片」去掉它们),有的对「*」后面多个空格的缩进风格有不同的渲染。先在你的软件里检查是哪一类元素有问题,通常是图片或表格,再针对性地修改。

常见问题:加粗、斜体会不会漏掉?

在 Word 里用「加粗」「倾斜」按钮设置的格式会被识别。但如果文字只是套用了某种自定义样式而看起来是粗体,转换库不一定会把它当成加粗。想确认的话,转换后在结果框里搜索星号和下划线。

常见问题:转换结果可以直接用在发布平台上吗?

适合作为初稿。建议你在目标平台的预览里核对标题层级、列表、链接以及图片,再根据上面列出的限制逐项修正后发布。

隐私与处理方式

文件在浏览器里读取,转换所需的两个库在你使用时由页面按需加载,转换在本地完成,代码中没有向服务器发送文档内容的网络请求。转换结果只保存在当前页面的内存里,关闭或刷新页面后即消失。