通过 Markdown→DOCX→Drive 上传的间接路径，填补 gog CLI 无法写入 Google Docs 的功能空白，实现从 Markdown 一键生成可编辑的 Google 文档。
说明：
## 核心用法
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 来自外部源，企业环境建议预置可信版本替代自动下载
会员专属
