DOCX转Markdown转换器
要把文档从Word迁移到Git仓库，第一步就是把每个.docx转换为Markdown。本工具输出CommonMark风格的文本，包含 # 标题、管道表格和图片链接，可直接提交。
文档转换器
或将PDF, DOC, DOCX … 文件拖放到此处 ·
单个文件最大 95 MB· 最多 20 个文件· 30 分钟后删除
文件在我们的服务器上处理，并在 30 分钟后删除。
150 DPI 会把一页 A4 转为约 1240 × 1754 px。需要打印时请用 300。
转换整个文件，或只转换部分页面或幻灯片（适用于 PDF 和演示文稿输入）。
要转换的页面或幻灯片，例如 1-3, 5, 8-10。
UTF-8 适用于所有语言。如果 Windows 上的 Excel 或记事本显示乱码，请选择带 BOM 的 UTF-8；旧编码仅用于老软件。
LF 适用于 macOS、Linux 和代码编辑器；CRLF 适用于较旧的 Windows 程序，如经典记事本。
逗号是标准分隔符。在以逗号作小数点的国家（德国、法国、巴西）使用 Excel 时，请用分号。
包含多个工作表的 Excel 输入：全部转换（每个工作表一个部分或文件），或只转换第一个。
使用方法
- 1
上传Word文件
最多添加 20 个 .docx 或 .doc 文件，每个不超过 95 MB。Markdown 无法显示修订记录，请先在 Word 中接受或拒绝所有修订。
- 2
检查文本选项
格式默认为简单，文本编码为 UTF-8，换行符为 LF，这是 Git 和静态网站生成器所期望的组合。保持开启包含图片，图片会保存到单独的文件夹中。
- 3
转换并解压
点击转换为 MD。每个文档会生成一个 ZIP，内含 .md 文件及其图片；解压到你的文档文件夹后提交即可。
如何把 Word 文档转换为 Markdown？
上传 .docx 并点击转换为 MD。你会得到一个包含 # 标题、列表、链接和表格的 .md 文件，图片则放在旁边的文件夹中，全部打包在一个 ZIP 里。
DOCX转Markdown，用于文档即代码
团队采用“文档即代码”只有一个原因：文档与代码放在一起，经过同样的拉取请求，随同一个版本发布。.docx 做不到这一点，因为它是由 XML 部分组成的 ZIP，Git 只把它当作不透明的二进制文件存储。改一个字，也只显示为文件已更改，看不到可读的差异，两个人同时编辑还无法合并各自的成果。
Markdown 是纯文本，每次修改都是清晰可见的行变化。2014 年，John MacFarlane 等人发布了 CommonMark，对 Gruber 十年前较为松散描述的语法给出了精确规范，Markdown 也由此变得可预测得多。2017 年，GitHub 以 CommonMark 为基础制定了自己的 GitHub Flavored Markdown 规范，加入了如今多数 README 都在用的竖线表格、任务列表和删除线。
如果内容需要反方向流转，也就是把 Markdown 发给习惯用 Word 的审阅者，请使用 Markdown 转 DOCX。如果是用于网页而不是代码仓库，DOCX 转 HTML 能保留更多样式。
Markdown输出是什么样子
## 发布检查清单 打发布标签前，请确认以下事项： - **main** 分支上的测试全部通过 - 更新日志列出了所有已合并的 PR | 步骤 | 负责人 | | --- | --- | | 构建 | CI | | 发布 | 维护者 | 
转换后的Markdown可以在哪里显示
| 机构 | 要求 | 来源 |
|---|---|---|
| GitHub | 使用 GitHub Flavored Markdown 渲染仓库中的 README.md 和任何 .md 文件 | github.com |
| Hugo | 使用符合 CommonMark 的解析器，从 .md 内容文件生成页面 | gohugo.io |
| Jekyll | 把带有 front matter 的 .md 文件转为页面；GitHub Pages 背后的引擎 | jekyllrb.com |
| Docusaurus | 把 docs 文件夹中的 .md 和 .mdx 文件读取为文档页面 | docusaurus.io |
DOCX
Microsoft Word 文档
DOCX 是自 Office 2007 起 Microsoft Word 的默认文档格式,基于 Office Open XML 标准(ECMA-376、ISO/IEC 29500)。它是由 XML 文件组成的 ZIP 包,包含文本、样式、图像、表格、批注和修订记录。它是办公室、学校和求职中最常见的可编辑文档格式。在 Word、Google 文档、LibreOffice 和 Pages 之间,版式可能略有变化,格式复杂时尤其如此。大多数文字处理软件都能打开 DOCX 文件。
- 压缩方式
- –
- 透明度
- –
- 动画
- –
- 发布年份
- 2007 · Microsoft
MD
Markdown
Markdown 是 John Gruber 于 2004 年创建的轻量级标记语法。它使用纯文本符号，例如用 # 表示标题、用 * 表示强调、用 - 表示列表，这些符号在原始文本中依然易读，也能干净地转换为 HTML。它是 README 文件、文档、维基、笔记应用和许多静态网站生成器的标准。它有多种方言，例如 CommonMark 和 GitHub Flavored Markdown，在表格等细节上有所不同。任何文本编辑器都能打开 .md 文件。
- 压缩方式
- –
- 透明度
- –
- 动画
- –
- 发布年份
- 2004 · John Gruber
当文档要进入代码工作流时，就需要把 DOCX 转换为 Markdown，例如 README、文档网站或存放在 Git 中的知识库：纯文本可以对比差异、在拉取请求中审阅，也能被许多工具渲染。
在Markdown中没有对应功能的Word特性
转换前请先规划好这些内容
- 字体、颜色和页面布局会被丢弃；Markdown 只描述结构，外观由网站主题决定
- 修订和批注不会保留，请先在 Word 中处理完
- 页眉、页脚和页码在 .md 文件中没有位置
- 文本框和环绕图片会变成普通段落和图片链接
- 手动设置格式的标题（例如加粗 16 磅而不是标题 2）会变成加粗文本，因此请先应用真正的标题样式
- 下划线在 Markdown 中没有对应语法，会被移除或保留为 HTML
DOCX转Markdown常见问题
DOCX转MD输出的是哪种Markdown语法？
标题、强调、列表、链接和代码遵循 CommonMark，表格使用 GitHub Flavored Markdown 的竖线语法。GitHub、GitLab、Hugo、Jekyll 和 Docusaurus 都能渲染这种组合。
表格中的合并单元格会怎样处理？
Markdown 竖线表格不支持合并单元格，因此每个合并区域会拆回单独的单元格，文字放在第一个单元格中。复杂表格可在 .md 中改用 HTML 重建，或在转换前先在 Word 中简化。
Word文档里的图片会放在哪里？
开启包含图片后，每张图片都会作为单独文件保存在 ZIP 中，Markdown 通过相对路径引用，例如 images/figure-1.png。移动 .md 文件时，请把该文件夹放在它旁边。
Word脚注转换为Markdown后还会保留吗？
CommonMark 没有脚注语法，但 GitHub 在 2021 年加入了 [^1] 脚注，大多数网站生成器也支持。如果你的渲染器不支持，脚注内容会作为普通段落显示在末尾。
可以用这种方法把Google Docs转换为Markdown吗？
可以。在 Google 文档中选择文件 > 下载 > Microsoft Word (.docx)，然后把该文件上传到这里。Google 文档本身也提供 Markdown 下载选项，适合简单文档。
