gdoc-vim:用 vim 直接编辑 Google Docs

我很喜欢 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。

关于albert

一个软件工程师, 一个准GEEK; 爱旅行, 爱发呆; 喜欢阅读科幻小说, 喜欢看电影, 喜欢玩打游戏; 心中有一个大大的梦想, 用这个网志不断的激励自己去完成.
此条目发表在工具分类目录。将固定链接加入收藏夹。

发表评论