大家好,我是栈长。
大家都知道,程序员这个职业需要不断总结,对我印象最深的一件事是,我曾经花了几天时间解决了一个惊天 bug,而几个月过后,这个 bug 再次发生了,我知道我之前解决过这个 bug,但再次发生时却束手无策,怎么想也想不出当时是怎么解决的。。
相信大家都有遇到过这样的场景吧?
所以,自从那件事过后,每次解决了什么难解决的问题我都会把解决方案记下来,后面做了系统架构师,也会督促团队成员记录日常 bug 及解决方案的习惯,这样能帮到自己,也能让其他人少走弯路。
工作、生活的琐事太多,我不相信这世上有超人,就算记性再好,过一段时间也会忘记的。虽然后面我养成了记笔记、写文章、写博客的习惯,但现在回过头去看那些文章,我也很难相信那居然是自己写的,所以,好记性不如烂笔头,这句话是非常有道理的。
说到写文章,栈长这些年用过好几个笔记工具,大家也都耳熟能详的,但都被我抛弃了,最后选择了一个国外的 Markdown 文章工具,还是付费的,选择它是因为它所见即所得,重点是对代码块支持比较好,但是有一个致使的缺点——不能云同步,需要借助其他工具完成同步,真是鸡肋。
所以,说实话,我一直没找到一款称心如意的笔记工具。。。
但最近我发现有款文档软件非常火,语雀,蚂蚁集团出品的,因为和同事经常有一些资料上的分享、协助,所以,总会有人发一些语雀的链接给我,让我看看、协助改下,出于好奇,我问了问同事,他说语雀界面很干净清爽,支持 Markdown、画板、思维导图、流程图…
话说同事那次推荐之后,我也顺便下载体验了下,体验之后我就离不开它了,果断从其他工具迁移到了语雀。因为我平时信息太多了,平时总要记一些随想、事项、代码思路、知识笔记、文章等,栈长要用好几个工具来完成这些,太乱又没有章程,而语雀一个就够了,着实提高了我的生产力。
今天,我也毫不吝啬,也分享下我是怎么用语雀的。
1
某个工作日,早上 10 点多,栈长正噼里啪啦敲着代码,突然遇到一个技术问题一筹莫展,一番研究后,最终解决了。
但,迫于事情的紧迫性,当时没有时间做再过多的研究,于是随手按了下 "ctrl shift y" 把问题和临时解决方案小记了一下:
工作空闲之余,栈长打开了语雀客户端,找到小记,并把它移动了对应的知识库:
然后花时间把它形成了一篇解决方案文章,这样,一件事情就能有始有终,也能解决我平时要用多个软件管理事项、文章的困扰。
现在回想起以前那些发送聊天助手、收藏骚操作,真是太 Low 了,虽然用起来很方便,但是太零散了,也不能形成知识闭环,而且还会经常忘记,说话,你们是不是也有这样做的?
2
周末,窗外下着暴雨,刮着台风,世界末日一般,市政府也提醒我不要去海边,出门也要注意安全,没办法,只能呆在家。
于是我打开了语雀客户端,看看还有啥要做的,发现要写的文章真不少,有些都堆积好些时日了,栈长写文章一顿操作猛如虎,还意外发现了语雀的许多妙用。
Markdown 语法随心应手:
大纲标题直接输入 #
号空格即可,比如一级标题(#)、二级标题(##)、三级标题(###)等等…
想引用某个链接,输入 >
空格即可。
想要插入代码,输入 ```
回车即可。
等等以上这些用法,还是 Markdown 原来的配方,熟悉的味道,迁移过来没有任何门槛磕绊,这是值得称赞的。
语雀还支持各种快捷指令,指令就是功能点的拼音首字母缩写,比如:代码块 = /dmk
,我输入 /dmk
就能插入代码块:
没错,如果不是 Markdown 用户,快捷指令也能愉快地写作,这效率太高了,太有意思了。
程序员写作不能没有代码块,既能选择指定的编程语言,不同的语言还要有不同的样式,还要能选择代码主题:
写的兴致来了,需要来张思维导图,以往写作时需要跳出笔记工具在第三方画图,再粘贴进来,而现在只需要一个 /swdt
指令,思维导图模块就呈现给我了:
以上是模板,下面是我真实画的:
当然这只是小菜,只要有需要,平时工作中要用的各种流程图(/lct)、UML 图(/uml),甚至是画板(/hb),在强大的素材库加持下都可以顺手拈来:
这个画板真是太灵活了,是我见过最强大的,画板上面可以是多个任何图形,比如上面所说的思维导图,其实就是画板承载的,画板的能量真的巨大,有非常大的可利用的空间,给同事分享时画了几张图,完了立即就成为文章素材。
为什么语雀编辑器对程序员这么友好?
栈长了解了下,原来语雀最早诞生于支付宝体验技术部,这是一个设计师和工程师居多的团队,所以,它一开始就是写给咱们程序员自己用的工具,这可能也是我为什么这么快适应它的原因吧。
3
栈长毕业多年,写的技术文章也有几百上千篇了,散落各地,存于各个笔记工具,至今它们也没有好好团聚,也是时候好好整理一下了。
语雀也提供了知识库功能,可以分类整理成自己的私密文章,你看,这是我创建的 Java 个人私密知识库,导入上传的一些 Java 类的文章:
看起来真的很舒服,还是云同步,以后我就可以多端编辑写作了,虽然创建的是个人私有的知识库,但我也能很灵活自在的分享给其他人阅读、编辑,比如我想分享给某个同事看:
同事某方面技术能力不错,想邀请他共同创作和评论:
知识库、单篇文章的权限都可以灵活设置,这一切都取决于你。
4
好了,知识库也构建完成了,以往都是要手动复制文章再部署到博客,这个过程确实很难受,直到我看到语雀的开发者服务 Webhooks:
语雀丰富的 API 和 Webhooks 助我打通了第三方生态,和 Github 的 Webhooks 一样,这是一种触发某种事件主动通知机制,你看,下面我定制了知识库发布文档、更新文档动态:
一旦文章更新就能推送给我的服务器,然后服务器通过语雀 API 从知识库获取文章更新博客,这样写完文章就能自动部署博客了,保证博客能和语雀实时同步,也完成了知识从小记 > 文章 > 知识库 > 博客的整个流程,从内到外打通知识的边界,让文档不仅局限在语雀之内。
再补充下,所有 API 都需要 Token 授权访问,我们需要在个人中心创建 Token:
刚写完文章,就自动部署博客了,我们常说,不要盲目加班,不要把大量时间花在重复的事情上面,工作要提高效率,瞧,部署了这个免费机器人博客就不用我管了。
以上就是我的一点分享,并不是全部,谈谈总结吧:
1、小记、文章、知识库,它们都是独立的,但也是可以相互依存的,好好利用,可以把杂乱的信息汇聚起来,让信息更聚焦,而不是各自为营,很大程度上可以提升效率。
2、这是我见过的最强大的编辑器,支持 Markdown / 快捷指令,可以插入代码块、公式、视频、各种流程图、画板等,甚至是第三方的服务,这块的能量巨大,几乎可以胜任任何高级别的文章编写。
3、程序员专属能力,除了强大的编辑器,还有开放的生态和开发者服务,可以满足一些对于文档有个性化要求的程序员,比如:Webhooks,让文档不只是文档,还能瞬间成为博客。
……
以上,其实还有更多,语雀太好玩了。