大家好,我是栈长。

大家都知道,程序员这个职业需要不断总结,对我印象最深的一件事是,我曾经花了几天时间解决了一个惊天 bug,而几个月过后,这个 bug 再次发生了,我知道我之前解决过这个 bug,但再次发生时却束手无策,怎么想也想不出当时是怎么解决的。。

相信大家都有遇到过这样的场景吧?

所以,自从那件事过后,每次解决了什么难解决的问题我都会把解决方案记下来,后面做了系统架构师,也会督促团队成员记录日常 bug 及解决方案的习惯,这样能帮到自己,也能让其他人少走弯路。

工作、生活的琐事太多,我不相信这世上有超人,就算记性再好,过一段时间也会忘记的。虽然后面我养成了记笔记、写文章、写博客的习惯,但现在回过头去看那些文章,我也很难相信那居然是自己写的,所以,好记性不如烂笔头,这句话是非常有道理的。

说到写文章,栈长这些年用过好几个笔记工具,大家也都耳熟能详的,但都被我抛弃了,最后选择了一个国外的 Markdown 文章工具,还是付费的,选择它是因为它所见即所得,重点是对代码块支持比较好,但是有一个致使的缺点——不能云同步,需要借助其他工具完成同步,真是鸡肋。

所以,说实话,我一直没找到一款称心如意的笔记工具。。。

但最近我发现有款文档软件非常火,语雀,蚂蚁集团出品的,因为和同事经常有一些资料上的分享、协助,所以,总会有人发一些语雀的链接给我,让我看看、协助改下,出于好奇,我问了问同事,他说语雀界面很干净清爽,支持 Markdown、画板、思维导图、流程图…

话说同事那次推荐之后,我也顺便下载体验了下,体验之后我就离不开它了,果断从其他工具迁移到了语雀因为我平时信息太多了,平时总要记一些随想、事项、代码思路、知识笔记、文章等,栈长要用好几个工具来完成这些,太乱又没有章程,而语雀一个就够了,着实提高了我的生产力。

今天,我也毫不吝啬,也分享下我是怎么用语雀的。

1

某个工作日,早上 10 点多,栈长正噼里啪啦敲着代码,突然遇到一个技术问题一筹莫展,一番研究后,最终解决了。

但,迫于事情的紧迫性,当时没有时间做再过多的研究,于是随手按了下 “ctrl + shift + y” 把问题和临时解决方案小记了一下:

工作空闲之余,栈长打开了语雀客户端,找到小记,并把它移动了对应的知识库:

然后花时间把它形成了一篇解决方案文章,这样,一件事情就能有始有终,也能解决我平时要用多个软件管理事项、文章的困扰。

现在回想起以前那些发送聊天助手、收藏骚操作,真是太 Low 了,虽然用起来很方便,但是太零散了,也不能形成知识闭环,而且还会经常忘记,说话,你们是不是也有这样做的?

2

周末,窗外下着暴雨,刮着台风,世界末日一般,市政府也提醒我不要去海边,出门也要注意安全,没办法,只能呆在家。

于是我打开了语雀客户端,看看还有啥要做的,发现要写的文章真不少,有些都堆积好些时日了,栈长写文章一顿操作猛如虎,还意外发现了语雀的许多妙用。

Markdown 语法随心应手:

大纲标题直接输入 # 号空格即可,比如一级标题(#)、二级标题(##)、三级标题(###)等等…

想引用某个链接,输入 > 空格即可。

参考链接:http://xx

想要插入代码,输入 ““` 回车即可。

等等以上这些用法,还是 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,让文档不只是文档,还能瞬间成为博客。

……

以上,其实还有更多,语雀太好玩了。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

发表回复

您的电子邮箱地址不会被公开。

评论(1)

  • 匿名 2022-08-24 19:36

    用了很久了