用语雀写文章了,功能真心强大!

组合露台
• 阅读 1525

大家好,我是栈长。

大家都知道,程序员这个职业需要不断总结,对我印象最深的一件事是,我曾经花了几天时间解决了一个惊天 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开发手册(嵩山版)》最新发布,速速下载!

觉得不错,别忘了随手点赞+转发哦!

点赞
收藏
评论区
推荐文章
Python进阶者 Python进阶者
3年前
只用3行Python代码,获取星期几?
大家好,我是皮皮。一、前言前几天在Python最强王者交流群分享了一个只用3行Python代码,获取星期几的问题,这里拿出来给大家分享下,一起学习下。看到这个代码,我当时的第一反应是,这个人基础学的还是可以的,input用到位了。对于初学者来说,能写成这样,也是不错的了,起码功能确实是实现了,虽然说起来确实有点说不上来的味道,应缺斯汀。二、解决过程有一说
捉虫大师 捉虫大师
3年前
惨,给Go提的代码被批麻了
hello大家好,我是小楼。不知道大家还记不记得我上次找到了一个Go的Benchmark执行会超时的Bug?就是这篇文章。之后我就向Go提交了一个PR进行修复,本想等着代码被Merge进去,以后也可以吹牛说自己是个Go的Contributor,但事情并不顺利,今天就来分享一下这次失败的代码提交。第一次提交在我意识到Bug时,就迫不及待想去修复,于是有了这一
捉虫大师 捉虫大师
3年前
刚出炉的《Java开发手册黄山版》,我帮你们圈出了改动点!
hello大家好,我是小楼相信写Java的同学应该都听过阿里巴巴的《Java开发手册》吧?我一开始写Java时,也读过这个手册,里面有很多关于代码格式,代码规约的正例、反例,简直就是居家旅行必备的手册。比如我印象中最深刻的是关于三目运算可能导致空指针的例子,我记得当时为了理解这个例子,还去查看了反编译的class文件:【强制】三目运算符condition
Wesley13 Wesley13
3年前
2个小bug,有点小门道
还有近1个月就要离职了,最近整理下解决过的问题,发现2个小bug,有点小门道。Bug1:2017年的某日,小辉(我的同事)遇到了一个bug,解决了一下午还是没有找到,气的摔键盘,骂人,我看在眼里,急在心中。在他发作了5分钟后。我提心吊胆的问:    “小辉,别着急遇到了什么问题啊?大家一块看看吧!“小辉:   
Wesley13 Wesley13
3年前
MySQL 查询不区分大小写的问题以及编码格式问题
查询不区分大小写最近,在用SSH框架完成一个实践项目时,碰到了一个莫名其妙的Bug困扰了我好久,最后终于解决,记录如下。问题:同学在测试系统的时候突然发现,数据库保存的账户本来应该是admin,结果该同学用Admin账户居然登录成功了…………EXM???这样也行?好吧,我还是查找这个Bug发生的原因吧。然后就是各种排查程序的过程
李志宽 李志宽
3年前
太强了哎!突然发现一个网安神器~
大家好,我是周杰伦。关注我的朋友,基本上都是从事网络安全行业,或者打算进入这个行业的。那问大家一个问题:你们知道乌云吗?我估计,有相当一部分同学的回答是不知道。时间如果倒退到五年前,一个网络安全人说不知道乌云,一定会被当作门外汉笑话的。而如今五年过去,乌云,这个曾经盛极一时安全论坛,逐渐消失在人们的记忆中。乌云论坛创建于2013年,创始人之一就是ID为“剑心
Wesley13 Wesley13
3年前
C#代码中为数据库开启多线程进行数据更新引起的BUG总结。
   刚开始编程的时候,对多线程有着盲目的崇拜。遇到需要调用写的方法,就想用多线程来进行调用。结果这几天才发现了软件中的BUG,看来多线程也不是想用就能用的,用不好就会非常糟糕,导致一些莫名其名的BUG。        我写了一个数据库的小例子,也验证了这个BUG是确实存在的。首先呢,我在数据库中创建了两个字段的表格,两个字段分别为M,N。其中M我设
Stella981 Stella981
3年前
Redis客户端多线程跟多个连接不是一回事
先抱怨一波,大国庆节的放假前一天的下班前15分钟,通知让我加班,因为一个Redis的bug,而这个bug我在1个半小时之前刚听说了个大概,心里很不情愿;好了,说正事;问题现象:bug是这样的,两个线程同时请求Redis服务器,但是只有一个线程收到了回复,另一个线程卡死;拿到这个问题,我先是想了想到底怎么查,于是想了可能出问题的
Python进阶者 Python进阶者
2年前
各位大神,我这代码,咋替换不成功?
大家好,我是皮皮。一、前言前几天在Python白银交流群【崔艳飞】问了一个Pandas处理的问题,这里拿出来给大家分享下。二、实现过程这里【瑜亮老师】给了一个解决思路,如下图所示:顺利地解决了粉丝的问题。虽然有警告,但是不影响操作。三、总结大家好,我是皮皮
Python进阶者 Python进阶者
1年前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这
sum墨 sum墨
9个月前
《花100块做个摸鱼小网站! 》第一篇—买云服务器和初始化环境
大家好呀,我是summo,前面我已经写了我为啥要做这个摸鱼小网站的原因,从这篇文章开始我会一步步跟大家聊聊我是怎么搭起这个网站的。我知道对很多新手来说,建网站可能挺头大的,不知道从哪里开始,所以我会尽量写得简单明了,让大家一看就懂,少走弯路。