Markdown 一键转 Google Docs

通过 Markdown→DOCX→Drive 上传的间接路径，填补 gog CLI 无法写入 Google Docs 的功能空白，实现从 Markdown 一键生成可编辑的 Google 文档。

基本信息

• 技能名称?Google Docs from Markdown
• 中文名称?Markdown 一键转 Google Docs
• 作者?techlaai
• 分类?专业技能
• 版本?1.0.1
• 标签?google-docs, markdown, cli-tool, document-conversion, gog, automation, pandoc

使用方法

使用说明
核心用法
gdocs-markdown 解决了 gog docs CLI 无法直接写入或更新 Google Docs 内容的痛点。该技能采用迂回策略：先将 Markdown 转换为 DOCX 格式，再通过 Google Drive 上传（Drive 会自动将 DOCX 转换为 Google Docs 格式）。主要入口是 gdocs-create.sh 脚本，支持一键完成整个流程，也允许用户分步手动执行以获得更精细的控制。
显著优点
填补 CLI 功能空白 ：绕过 gog docs 仅支持 create/export/cat/copy 的限制，实现内容填充
格式兼容性好 ：借助 pandoc 进行 Markdown→DOCX 转换，保留大部分排版格式
自动化程度高 ：单条命令即可完成从本地 Markdown 到云端 Google Docs 的完整链路
pandoc 自托管 ：首次使用时自动下载 pandoc 二进制文件，降低环境配置门槛
潜在缺点与局限性
间接依赖风险 ：流程涉及 pandoc 下载、DOCX 中转、Drive 格式转换三个环节，任一环节失败都会导致整体失败
权限配置繁琐 ：安装后需手动执行 chmod +x 修复脚本权限，体验不够流畅
临时文件残留 ：转换过程中产生的 DOCX 文件默认保留在 Drive，需手动清理
格式转换损耗 ：复杂 Markdown 特性（如高级表格、数学公式）在 DOCX→Google Docs 二次转换中可能丢失
网络依赖重 ：pandoc 下载和 Drive 上传均需外网连接
适合人群
习惯用 Markdown 写作但需要最终交付 Google Docs 格式的用户
使用 gog CLI 进行 Google Workspace 自动化管理的开发者
团队协作中需要将版本控制的 Markdown 文档同步到 Google Drive 的场景
常规风险
凭证泄露 ：脚本运行依赖 gog CLI 的 Google 账号认证，共享环境需注意凭证隔离
临时文件安全 ：转换过程中的 DOCX 文件在 /tmp 和 Drive 中短暂存在，敏感文档需注意清理
第三方二进制 ：自动下载的 pandoc 来自外部源，企业环境建议预置可信版本替代自动下载