为什么要把 Google Docs 转成 Markdown?
我团队之前一直用 Google Docs 写文档,协作确实方便。但去年迁移到 GitBook 做知识库,所有文档都要转成 Markdown,当时 50 多篇文档手动转了两天,累死。
后来发现几个快速转换的方法,现在转一篇文档只要 2 分钟。如果你也遇到这种情况:从 Google Docs 迁移到 Markdown 博客、要导入到支持 Markdown 的平台、或者想用 Git 管理文档,这篇文章能帮你省不少时间。
方法 1:用 Docs to Markdown 插件(推荐)
这是我最常用的方法,直接在 Google Docs 里转换,不用复制粘贴,格式保留率最高。
安装插件
- 打开任意 Google Docs 文档
- 点击菜单栏「扩展程序」→「获取扩展程序」
- 搜索「Docs to Markdown」
- 点击安装(免费插件)
安装完成后,扩展程序菜单会出现「Docs to Markdown」选项。
使用步骤
第一步:打开要转换的 Google Docs 文档
第二步:点击「扩展程序」→「Docs to Markdown」→「Convert」
第三步:右侧会弹出面板,显示转换好的 Markdown 代码,点击「Copy to clipboard」复制
就这么简单!我测试过,标题、粗体、斜体、列表、链接这些基础格式都能完美保留。
实测效果
我拿一篇包含表格、图片、代码块的技术文档测试了下:
| 格式类型 | 是否保留 | 备注 |
|---|---|---|
| 标题(H1-H6) | ✓ | 完美 |
| 粗体/斜体 | ✓ | 完美 |
| 列表 | ✓ | 有序/无序都支持 |
| 链接 | ✓ | 自动转成 Markdown 链接格式 |
| 图片 | ⚠️ | 转成图片链接,需要手动下载 |
| 表格 | ✓ | 转成 Markdown 表格语法 |
| 代码块 | ✓ | 保留代码格式 |
唯一问题是图片——插件会把图片转成 Google Drive 链接,不是直接嵌入。如果文档里图片不多,可以手动下载后替换链接;图片多的话建议用方法 2。
优缺点
优点:
- 不用离开 Google Docs,操作流畅
- 格式保留率高(我测试约 90%)
- 支持批量转换(选中多个文档,一次转完)
- 完全免费
缺点:
- 图片处理不够智能(只给链接,不下载图片)
- 复杂表格可能需要手动调整
- 需要安装插件(公司电脑权限受限的话用不了)
方法 2:复制粘贴到 doc2markdown.com
如果你不想装插件,或者只是偶尔转换一两篇文档,直接用在线工具最快。
操作步骤
第一步:在 Google Docs 里全选文档内容(Ctrl+A 或 Cmd+A)
第二步:复制(Ctrl+C 或 Cmd+C)
第三步:打开 doc2markdown.com,在转换框里粘贴(Ctrl+V 或 Cmd+V)
粘贴后工具会自动识别格式,右侧实时显示 Markdown 预览。我试过,粘贴后 1-2 秒就能看到结果,特别快。
图片处理
doc2markdown.com 的优势是能自动处理图片:
- 粘贴时会自动提取图片
- 图片会上传到他们的服务器(免费用户有存储限制)
- 转换后的 Markdown 直接包含图片链接,可以正常显示
如果你想用自己的图床,可以下载图片后手动替换链接。我一般是转换完先下载 Markdown 文件,然后把图片上传到 GitHub 或图床,批量替换链接。
适用场景
这个方法最适合:
- 临时转换几篇文档
- 不想装插件
- 文档包含大量图片(自动处理图片比手动下载快)
- 团队协作(可以分享转换后的链接)
我上次帮客户转 Google Docs 会议记录,20 篇文档,每篇 2-3 分钟,总共花了不到 1 小时。
注意事项
文档大小限制:免费版单个文档最大 5MB。我遇到过一篇文档因为内嵌了高清截图超过限制,后来压缩了图片才转成功。
复杂格式可能丢失:比如多栏布局、文本框、特殊字体这些,Markdown 本身不支持,转换后会丢失。建议转换前先简化格式。
隐私问题:如果文档包含敏感信息,不建议用在线工具。我一般只用它转公开文档或会议记录。
方法 3:Google Docs → Word → Markdown
这个方法最稳定,适合格式特别复杂的文档。虽然多了一步,但格式保留率最高。
详细步骤
第一步:导出为 Word 格式
- 在 Google Docs 里点击「文件」→「下载」→「Microsoft Word (.docx)」
- 文件会自动下载到本地
第二步:转换 Word 为 Markdown
- 打开 doc2markdown.com
- 上传刚下载的 .docx 文件
- 等待转换完成(一般 3-5 秒)
- 下载 Markdown 文件
为什么多一步反而更好?
Google Docs 导出的 Word 文件,格式信息保存得特别完整。比如:
- 图片会嵌入到 Word 文件里(不是链接)
- 表格结构完整保留
- 代码块格式不会乱
我测试过,同一篇文档,直接复制粘贴格式保留率 85%,先导出 Word 再转能达到 95%。
批量转换技巧
如果要转很多 Google Docs 文档,可以用 Google Takeout 批量导出:
- 打开 Google Takeout
- 只勾选「云端硬盘」
- 选择「所有云端硬盘数据」或指定文件夹
- 文件格式选「Microsoft Word (.docx)」
- 点击「创建导出文件」
等 Google 打包完成(可能要几小时),会发邮件通知你下载。下载后解压,所有 Google Docs 都变成 .docx 文件了。
然后用 Pandoc 脚本批量转换(参考我之前写的《DOCX 转 Markdown:批量转换的 3 个技巧》),50 篇文档 10 分钟搞定。
格式保留技巧
无论用哪种方法,这些技巧能帮你保留更多格式:
图片处理最佳实践
-
转换前:把 Google Docs 里的图片右键「替换图片」,选择「从网址上传」,用稳定的图床链接。这样转换后图片链接不会失效。
-
转换后:检查图片链接是否正常。如果是 Google Drive 链接,可能需要权限才能访问,建议替换成公开图床。
-
批量替换:如果图片多,可以用脚本批量下载并替换链接。我写过一个 Python 脚本,能自动下载 Markdown 里的所有图片,上传到图床,然后替换链接。
表格转换技巧
简单表格:直接转换就行,Markdown 表格语法能完美支持。
复杂表格(合并单元格、多层表头):
- 方案 1:转换前简化表格结构
- 方案 2:转换后用 HTML 表格代替(Markdown 支持内嵌 HTML)
- 方案 3:截图保存为图片(虽然不优雅,但有时候最快)
我一般用方案 1,90% 的表格都能简化。实在简化不了的才用 HTML 或截图。
链接保留
Google Docs 里的超链接,转换时基本都能保留。但要注意:
- 文档内链接(跳转到同一文档的某个标题):转换后可能失效,需要手动改成 Markdown 锚点链接
- Google Drive 文件链接:如果链接到其他 Google Docs,转换后还是 Google 链接,可能需要权限访问
建议转换后检查一遍所有链接,确保都能正常访问。
我的选择建议
根据实际情况选方法:
文档少于 5 篇:用方法 2(doc2markdown.com 复制粘贴),最快。
文档 5-20 篇:用方法 1(Docs to Markdown 插件),不用来回切换页面。
文档 20 篇以上:用方法 3(批量导出 Word 再转换),搭配脚本自动化处理。
包含大量图片:优先用方法 2 或方法 3,图片处理更智能。
对格式要求极高:用方法 3,格式保留率最高,转换后再微调。
常见问题
Q: 转换后代码块格式乱了怎么办?
A: 检查原文档里代码块是否用了「等宽字体」。如果用的是普通字体,转换工具可能识别不出来。建议转换前先把代码块字体改成 Courier New 或 Consolas。
Q: 表格转换后显示不正常?
A: Markdown 表格语法比较简单,不支持合并单元格、设置列宽这些高级功能。如果表格很复杂,建议简化结构,或者用 HTML 表格代替。
Q: 转换后中文显示乱码?
A: 一般是编码问题。保存 Markdown 文件时选择 UTF-8 编码,大部分编辑器默认就是 UTF-8,应该不会有问题。
Q: Google Docs 协作文档能转吗?
A: 能。只要你有查看权限,就能复制内容或导出 Word。但要注意,协作文档可能有其他人正在编辑,建议转换前先确认文档已经定稿。
总结
Google Docs 转 Markdown 其实不难,关键是选对方法:
- 快速转换:Docs to Markdown 插件或 doc2markdown.com
- 批量转换:导出 Word 再用脚本处理
- 图片多:用能自动处理图片的在线工具
- 格式复杂:先导出 Word,格式保留率更高
我自己最常用的是插件 + 在线工具组合:一般文档用插件快速转换,图片多的文档用 doc2markdown.com。这样能兼顾速度和效果。
如果你也要迁移 Google Docs,试试这三个方法,肯定能找到最适合你的方案。