核心用法
gdocs-markdown 解决了 gog docs CLI 无法直接写入 Google Docs 内容的痛点，通过 Markdown → DOCX → Drive 上传 的三步工作流实现内容填充。
主要操作方式：
- 快捷模式：运行
gdocs-create.sh /path/to/file.md "文档标题"一键完成转换与上传 - 手动模式：调用 pandoc 生成 DOCX，再通过
gog drive upload上传，Google Drive 自动完成 DOCX 到 Google Docs 的格式转换
显著优点
1. 填补工具缺口：官方 gog CLI 仅支持创建空文档/导出/复制，此技能实现了完整的"带内容创建"能力
2. 保留格式完整性：借助 pandoc 的成熟转换引擎，Markdown 的标题、列表、代码块等结构得以准确保留
3. 原生可编辑：上传后的文档为真正的 Google Docs 格式，非 PDF 或只读附件，支持团队实时协作
4. 零依赖配置：pandoc 在首次使用时自动下载，降低部署门槛
潜在局限
- 中间文件残留：DOCX 文件上传后仍存于 Drive，需手动清理
- 格式兼容性边界：复杂 Markdown（如嵌套表格、自定义 CSS）可能转换失真
- 外部工具链依赖：需同时维护 gog CLI 认证状态与 pandoc 版本
适合人群
- 使用 gog CLI 管理 Google Workspace 的开发者/运维人员
- 需要将技术文档（README、API 文档）快速迁移至 Google Docs 协作文档库的工程师团队
- 偏好 Markdown 写作但交付物需为 Google Docs 格式的内容创作者
常规风险
- 认证令牌安全：脚本依赖 gog CLI 的 OAuth 凭证，共享环境需注意令牌权限范围
- 临时文件清理：/tmp 路径下的 pandoc 二进制与中间 DOCX 文件建议设置定期清理策略
- 版本漂移：pandoc 自动下载固定版本（3.1.11），长期可能需手动更新以支持新 Markdown 语法