Google Docs from Markdown

从Markdown文件创建Google文档。适用于将Markdown内容转为Google文档,或在使用gog CLI时需要填充文档内容的场景。由于gog CLI仅支持创建/导出等操作而不支持直接写入,此技能通过Drive上传实现 Markdown → DOCX → Google Docs 的转换。

安装

概览

Google Docs from Markdown 是一个专为开发者设计的实用工具,旨在解决 `gog` CLI 无法直接向 Google Docs 写入内容的问题。该工具通过一个简洁的三步工作流实现从 Markdown 到 Google Docs 的无缝转换:先将 Markdown 文件转换为 DOCX 格式,再上传至 Google Drive,最后自动转为可编辑的 Google Docs 文档。由于原生 `gog docs` 命令仅支持创建空文档、导出或读取现有内容,而无法注入实际文本,因此这一技能填补了关键功能缺口,使用户能够自动化地将技术文档、报告或其他结构化内容快速发布为在线协作文档。整个流程完全基于命令行操作,适合集成到脚本或 CI/CD 流水线中,极大提升了内容发布的效率与一致性。

核心功能特点

  1. 将任意 Markdown 文件自动转换为 Google Docs 格式
  2. 利用 gog CLI 和 pandoc 实现端到端无干预转换流程
  3. 生成的 Google Docs 可直接在浏览器中编辑和共享
  4. 支持自定义文档标题,便于批量管理输出内容

适用场景

该工具特别适合需要频繁将技术笔记、项目文档或会议纪要从 Markdown 发布为协作文档的场景。例如,开发团队可以使用它自动生成 API 文档、更新日志或周报,并直接推送到 Google Workspace 环境供成员审阅和评论。对于内容创作者而言,撰写博客草稿后一键转为 Google Docs 进行多轮协作修订也极为高效。此外,在自动化部署流程中,结合 CI 系统调用此脚本,可实现‘代码提交即生成文档’的智能发布机制,减少手动操作带来的延迟与错误。无论是个人知识管理还是企业级文档协同,该方案都提供了轻量且可靠的解决方案。