我很喜欢 vim,也喜欢在命令行里把事情做完。Google Docs 也很好用,共享、评论、版本历史都省心。
Google Docs 现在原生支持 Markdown 的导入和导出,把两者接起来就很自然了:文档还放在 Docs 上,编辑在 vim 里完成。于是写了这个小工具,gdoc-vim。
安装
pipx install gdoc-vim
用法
编辑一个已有的文档,URL 直接从浏览器地址栏复制:
gdoc-vim https://docs.google.com/document/d/FILE_ID/edit
它会把文档导出成 Markdown,用 vim 打开(或者你的 $EDITOR)。:wq 保存退出后,内容自动转换回去写入同一个文档——链接不变、共享设置不变、修订历史照常累积。
新建文档也可以直接开写:
gdoc-vim -n "会议记录"
换个编辑器
名字里虽然带 vim,但用什么编辑器都行,它认 $EDITOR:
export EDITOR=emacs
图形界面的编辑器要加上等待参数,比如 export EDITOR="code --wait",否则命令一启动就返回了,工具会以为你没做任何修改。
Google 授权
第一次运行需要配一下 Google 的授权:你要在 Google Cloud Console 建一个自己的 OAuth 客户端,大概三分钟,做一次就好。工具第一次跑的时候会在终端打印分步指引,跟着做就行。
有一个地方值得提醒:新建的 OAuth 客户端默认是 “Testing” 状态,这个状态下 Google 签发的 token 7 天就过期,得每周重新授权一次。在 Console 里把发布状态改成 “In production” 就好了,这一步不需要通过任何验证。
链接
GPL-3.0 协议。有问题或者建议,欢迎在下面留言,或者去 GitHub 提 issue。

