阿超 > word-to-markdown

word-to-markdown

2025-07-11

ruby

天地英雄气，千秋尚凛然。一一刘禹锡

Word to Markdown：让你的 Word 文档轻松变身高质量 Markdown

在技术写作、文档管理和博客搭建中，Markdown 已成为事实上的内容标准。但对于习惯用 Microsoft Word 编辑文档的用户来说，如何无损、自动地将 Word 文件转换为 Markdown，始终是一个令人头疼的问题。Word to Markdown 正是为此而生的开源工具，它能将 DOCX 文件精准、高效地转为 Markdown 格式，极大地便利了内容迁移和协作流程。

项目简介

Word to Markdown 是由 Ben Balter 维护的开源工具，支持将 Microsoft Word (DOCX) 文件批量、自动转换为 Markdown 格式。它基于 Node.js 实现，适合个人、团队和自动化流程使用。

  • 核心功能：将 Word 文档（.docx）转换为 Markdown (.md)
  • 技术栈：Node.js
  • 安装方式：npm 包
  • 适用场景：技术文档、博客迁移、知识库、开源项目文档统一格式等

主要特性

1. 高质量转换

Word to Markdown 能将 Word 的文本、标题、列表、表格、图片、链接等常见内容准确转换为标准 Markdown；支持复杂的嵌套结构，尽可能保留原始文档的语义和样式。

2. 命令行工具 & API

既可通过命令行直接使用，也能作为 Node.js 包集成到自动化流程或 Web 服务中，满足多样化使用需求。

3. 支持批量转换

可以一次性转换多个 Word 文件，便于团队大规模内容迁移。

4. 可扩展性强

支持自定义选项，包括输出目录、文件命名、保留原始内容属性等，灵活适配各种业务场景。

快速上手

1. 安装

1
npm install -g word-to-markdown

2. 基本用法

将一个 Word 文件转换为 Markdown：

1
word-to-markdown path/to/document.docx > document.md

3. 批量转换

支持一次性转换目录下所有 Word 文件：

1
word-to-markdown *.docx

4. 作为 Node.js 库集成

你可以在 Node.js 项目中引用并调用：

1
2
3
4
5
6
7
const wordToMarkdown = require('word-to-markdown');
const fs = require('fs');

const docxBuffer = fs.readFileSync('input.docx');
wordToMarkdown(docxBuffer).then(markdown => {
  fs.writeFileSync('output.md', markdown);
});

5. 更多选项

  • 自定义输出目录
  • 支持图片等资源的自动提取与链接转换
  • 保留或处理 Word 的元数据

详见 项目 README。

应用场景

  • 技术博客迁移：将 Word 编写的文章便捷转为 Markdown，适配 Hexo、Jekyll、Hugo 等静态博客系统。
  • 项目文档格式统一：开源项目团队可批量将 Word 说明书转为 Markdown，便于版本控制和协作。
  • 企业知识库建设：企业可将历史 Word 资料批量迁移到基于 Markdown 的知识管理平台。
  • 自动化文档流程：结合 CI/CD，将 Word 编辑的内容自动转换并发布为 Markdown 文档。

总结

Word to Markdown 是连接传统办公工具与现代技术写作生态的“桥梁”。它支持高质量、自动化地将 Word 文件转为 Markdown，极大地提升了内容迁移和团队协作效率。无论你是技术博客作者、开源项目维护者，还是企业文档管理员，Word to Markdown 都能为你的工作流带来极大便利。

项目主页：https://github.com/benbalter/word-to-markdown