什么是Md To Gdoc
Md To Gdoc 是一款专为开发者设计的自动化工具，旨在将本地 Markdown（.md）文件高效转换为格式规范的 Google Docs 文档。它通过调用 Google Workspace CLI 工具 gog 和 Python 脚本，实现了从原始文本到结构化在线文档的无缝迁移。该工具的核心价值在于确保转换后的文档不仅保留原文内容，还能正确应用 Google Docs 的样式体系，包括标题层级、粗体、代码块、列表、超链接以及引用块等常见排版元素。与简单的文本复制粘贴不同，Md To Gdoc 利用 Google Docs API 的 `update` 方法，是唯一能可靠生成带格式化标题的文档路径，从而满足对文档结构有严格要求的协作或发布场景。
核心功能特点
- 支持将 .md 文件中的各级标题（# 至 ######）自动映射为 Google Docs 的 Heading 1–6 样式
- 完整保留 Markdown 语法：粗体、行内代码、围栏代码块、块引用、无序/有序列表、超链接及表格均正确渲染
- 采用两步创建流程：先创建空文档，再通过 update 命令填充内容，确保操作确定性和可靠性
- 可通过命令行参数自定义输出文档标题、指定存放文件夹及选择使用的 Google 账号
适用场景
Md To Gdoc 特别适用于需要将技术文档、项目说明或知识库内容从 Markdown 环境迁移到 Google Workspace 生态的场景。例如，开发团队在 GitHub 或私有仓库中用 Markdown 编写 API 文档、产品需求或会议纪要后，希望这些内容能以标准格式在 Google Docs 中被审阅、评论和协作编辑，此时 Md To Gdoc 可一键完成转换并保留所有关键格式。此外，对于经常使用 Markdown 撰写博客草稿或内部报告的个人用户而言，该工具提供了一条高效的发布路径——直接将本地文件上传至 Google Drive 并生成可直接分享的在线文档，无需手动重新排版。需要注意的是，由于其依赖 gog CLI 进行身份验证和 API 调用，因此主要面向已接入 Google Workspace 且熟悉命令行操作的工程师或技术文档维护者。