用语雀写文章了，功能真心强大！

大家好，我是栈长。

大家都知道，程序员这个职业需要不断总结，对我印象最深的一件事是，我曾经花了几天时间解决了一个惊天 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.1,000+ 道 Java面试题及答案整理(2022最新版)

2.劲爆！Java 协程要来了。。。

3.Spring Boot 2.x 教程，太全了！

4.别再写满屏的爆爆爆炸类了，试试装饰器模式，这才是优雅的方式！！

5.《Java开发手册（嵩山版）》最新发布，速速下载！

觉得不错，别忘了随手点赞+转发哦！