Admonition:生来多彩

靠颜值征服实用主义者。

写在前面

嗨,大家!没想到这么快就又见了。

我一直写的是干货类文章,至今能够写进教程的插件,都是实用且有用的。不过今天,我要写的是一个最无用的插件

这有违我 “写大家能用上的教程” 的原则,但很快你就知道为什么了。

本来我不该写Admonition,因为我还欠着许多坑,比如quickAdd插件,比如经常被催的Templater插件,再比如同步教程。

本来我也没想写Admonition插件(的教程),因为我作为一个笔记实用主义者,不会推荐Admonition。对,你没看错,不推荐!它真的不适合你专心做笔记。

之所以写这篇文章,是因为:它真的,每个人看见截图都会问:这是什么插件?

不管你截图是想说什么话题,只要带Admonition效果的截图一出现,楼就会一下子歪到:好看!这是什么插件!

看看下面这张图:

QQ20210812-014520@2x.png

主题是每次不管我截图范围多小,都会有人问到的Blue Topaz主题,背景用了主题作者提供的in the sky片段,页面中呈现的就是Admonition插件的效果,同样是每逢出现必有人问。二者结合,杀伤力MAX。

最无用的插件

我用插件的原则一直是:如无必要,不增插件(来自奥卡姆剃刀原理)。

Admonition是唯一一个暂时没用到(因为无法放进工作流),还躺在我的第三方插件列表的——闲置插件。

说说我为什么不推荐

我反对将markdown搞成富文本那样花里胡哨,markdown之所以好用,就是你可以用写作的方式来排版,写完之后,排版也完成了,不需要多余做什么。不用操心字体、颜色、大小。

admonition在用的时候,你需要手动加代码块,然后还要对应上你设置的块类型。写完后,这个md文档拿到其他地方,脱离该插件,效果就会完全不对,成了普通代码块。

你写的文章中如果用了admonition,当你要发布的时候,你还需要去掉这部分语法,因为别的地方无法识别。

而且常常不稳定,我在测试插件的时候,多次预览出来的效果是乱掉的。

美貌是它唯一的优点

但我知道有很多同学,就是很喜欢富文本效果,喜欢那些炫酷文字和背景。这些在markdown中其实支持都不是很好。markdown生来就不是干这个的。

但有Admoniton是,它生来就对实用主义笔记没有用,它生来就是绚丽多彩,颜值高到一骑绝尘。

Admoniton:生来多彩。支持可选文字背景颜色,支持选择图标,效果炫酷,适合扮酷的guy.

它不满足你实用性的需求,只满足你“不经意间装一下”的需求。

让你的块引用更灵活

这个功能是小伙伴补充的,我们知道引用不能换行,否则引用块就断掉。Admonition的引用块效果不会,并且,你还能在引用块里写其他md语法,比如标题。这在有时候很管用,当你不想只引用一句话,而是一两个段落,或者干脆是带标题的段落,Admonition能为你做到。

安装与配置

台上三分钟,台下十年功。但还好,要想达到admonition一秒钟惊艳的效果,你只需要十分钟的准备工作。

首先,安装插件。不会安装第三方插件的新读者,可以去上一篇。两种安装方式,都可。

配置

重头戏来了!

1. 打开设置,在插件选项,找到Admonition,开始设置

2. 先打开前两个设置项的开关

20210812010623.png|500

3. 面板往下滑,找到Add New,点击右侧的➕,添加一个新的admonition 类型

20210812010647.png|500

4. 在弹出层,可以看到3个设置。

20210812010811.png|500

依次是:

  • Type 类型的名称:给类型起个名字,这里你可以自由填写。我例子中写的是“book”。
  • Icon 图标:这是个下拉框,你可以从中选择自己想要的图标。图标会显示在admonition块的左上角。
  • Color 颜色:这里是个颜色选择器,指定了admonition 块的颜色

随着修改这3项设置,下方可以实时看到预览效果。

20210812010911.png|500

5. 点击✅按钮,保存设置。

至此,一个类型的admonition块就设置好了。

开始秀

新建一个文件。老规矩,先放完整实例。

```ad-book
title: 《水调歌头》
明月几时有,把酒问青天。  
不知天上宫阙,今夕是何年。  
我欲乘风归去, 又恐琼楼玉宇,高处不胜寒,  
起舞弄清影,何似在人间。  

转朱阁,低绮户,照无眠。  
不应有恨,  
何事长向别时圆。
```

下面解释语法:

先看第一行,ad-是固定的写法,book是刚刚我们在设置中第一行填写的类型名称,注意区分大小写。

第二行,title字段,代表着设置标题,你也可以不写这一行,那么得到的块样式就会是以Book为默认标题。

还有一个可设置字段是collapse,意思是折叠块,冒号后面加一个空格,跟的是值。值填写“open”,是默认展开,值填写“close”是默认关闭。你可以像我一样不写这个设置,默认不折叠。

然后下面就可以写你的笔记内容啦。如果你不知道要写什么,不如复制上面的《水调歌头》试一试。

将笔记切换到预览模式看看:

20210812115409.png

这是一个admonition块的效果,如果你为自己设计了不同颜色和图标的类型,当使用在文章中的时候,就可以达到题图的效果。

漫游

我给自己按照需求设定了一套admonition类型和,用于做读书笔记。

20210812110320.png|350

不限于引用,还用来写对段落的理解、产生的思考、获得的灵感、产生的问题,等等所有你想要突出的内容。Admonition绝对让它耀眼到你忽略不了。

你也可以设计一套自己的类型样式,用于区分不同种类、不同用途的内容。

结语

怎么样,学会了吗?

现在,你只需要尽量自然的、不经意的把做出的效果拿给别人看,然后在别人的惊叹声中,表面微笑谦虚,内心狂喜:糟糕,又被我装到了呢!

哈哈哈!快去试试!

我是让你们的买家秀等同于卖家秀的莉莉安,谢谢你看到这里,下期再见。