SuperAPI AI 工具集

md-to-gdoc

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:把 .md 文件转换为带有正确标题样式、加粗、代码块、列表、链接和块引用的 Google Docs 文档。

主要能力:支持 #–###### 标题映射为 Google Docs 的 Heading 1–6;bold 转为加粗;inline code 与围栏代码块转为 Courier New(代码块带灰色背景);> 块引用转为缩进段落;- 与 1. 列表转为带前缀文本;text 转为超链接;Markdown 表格转为原生 Google Docs 表格。

使用方式:运行 scripts/md-to-gdoc.sh <file.md> [--title "Title"] [--parent <folder-id>] [--account <email>],scripts/ 路径相对本技能目录解析。选项:--title 指定文档标题(默认文件名,连字符转空格);--parent 指定 Google Drive 文件夹 ID;--account 指定 Google 账号邮箱(默认 gog 首个已认证账号)。

关键规则:必须使用 gog docs update --format=markdown,不要写 --markdown,也不要创建 --file;只有 update 路径能通过 API 正确应用 Google Docs 标题样式。采用两步流程:先创建空文档,再用 update 填充。Markdown 必须有正确的 # 标题标记,若源文件只有“看起来像标题”的纯文本,需先补上 #,脚本会警告但继续执行。

依赖:gog(Google Workspace CLI,需先认证:gog auth add <email>);python3(用于脚本中的 JSON 解析)。

已知限制:italic 可能无法渲染(gog CLI 内联格式解析器在特定上下文中斜体检测失败);项目符号/编号列表使用文本前缀(•、1.),而非原生 Google Docs 列表对象;水平线渲染为 40 个短横线。

故障排查:若正文全无标题,说明 Markdown 缺少 # 标题标记,需补上;若出现 gog 认证错误,运行 gog auth list 检查认证,可能需要 gog auth add <email>;若创建了空文档,说明 update 步骤失败,检查 gog 输出中的 API 错误。