逐项列出本站已支持的 VLOOK 语法及其渲染结果,可作为写作时的速查表。未实现的语法也一并标注,避免踩空。
这篇是本站 VLOOK 语法兼容情况的实测清单。每一节先给写法、再给效果,可以直接当速查表用。
标题编号由 frontmatter 里的 vlook-header-autonum: h2{{#}},h3{{#}} 生成,本页可见的章节序号就是它的产物。
1文字着色
VLOOK 用两位字母的色号着色,写法是下划线斜体套波浪线。之所以是这么绕的组合,是为了避开 Typora 里单星号斜体与加粗的冲突 —— 这是 VLOOK 自己的设计。
1.1单色
跟在文字后面即可:这段是红色
蓝色 / 绿色 / 紫色 / 金色 / 灰色
主题色 会跟着站点的主色走,换配色时不用改文章。
1.2实心强调
色号末尾加 ! 变成实心块:这段是实心蓝
实心红 / 实心绿
1.3渐变
多个色号相连即为渐变:红黄绿
蓝紫粉
1.4整段着色
色号独占一行时,作用于整个段落或整个引用块。
这是一个被整体着色的引用块,左侧会出现对应颜色的竖线。
这个用的是实心式,整块会带上淡淡的底色。
2高亮
==高亮== 是 Typora 的语法,GFM 默认不解析,本站补上了:这里有 一段高亮文字,可以和 之类混用。
3标签
用 *`标签`* 写出标签样式:草稿 已验证 v2.0
4注音
_^汉字(拼音)^_ 会渲染成 ruby 注音:漢字 、拉麵
5按钮链接
把 <kbd> 包在链接文字里,就会渲染成按钮:
6进度条
**==75%==** 会画成带轨道的进度条:
项目完成度 75%
测试覆盖率 42%
磁盘占用 93%
7刮刮卡
*提示**内容*** 会把内容遮住,点击或按回车揭开:
这道题的答案是 42
隐藏的密钥是 hunter2
8可折叠引用块
引用块首行写成六级标题,整块就可折叠:
点开看详细说明
折叠块适合放长篇的补充说明、报错日志、可选步骤这类内容 —— 需要的人能看到,不需要的人不会被淹没。
里面可以放多个段落,也可以放列表:
- 第一项
- 第二项
9图片魔法
在图片路径末尾加锚点即可控制排版。这些锚点会在渲染时被剥离,不会真的发到请求里。
9.1缩放
#40%、#400w、#200h 分别按比例、按宽度、按高度缩放。
9.2形状与边框
#round 圆角、#border 描边、#padding 内边距。
9.3滤镜
#gray 灰度、#blur 模糊、#aged 做旧、#invert 反色。末尾加 ! 表示鼠标悬停时恢复原样。
9.4翻转
#180deg 旋转、#fliph 水平翻转、#flipv 垂直翻转。
10表格增强
10.1单元格合并
单元格内只写 == 表示向左合并,只写 : 表示向上合并。
| 区域 | 第一季度 | 第二季度 | 备注 |
|---|---|---|---|
| 华东 | 1200 | 前两列已合并 | |
| 华南 | 860 | 940 | 正常两格 |
| 730 | 810 | 首列向上合并 | |
10.2列格式与数值
表头加粗让整列加粗,表头加删除线让该列不输出到页面;列设为右对齐时,数字会自动加千分位、缩小小数、给正负号着色,百分比还会带一条进度条。
| 名称 | 重点列 | 金额 | 同比 |
|---|---|---|---|
| 甲方案 | 首选 | 1,234,567 | +12.5% |
| 乙方案 | 备选 | -8,900.25 | -3.2% |
| 丙方案 | 待定 | 45,600 | 78% |
11与既有功能共存
VLOOK 语法不影响本站原有的 Markdown 能力,下面几项照常工作。
行内公式 与块级公式:
代码高亮:
// 代码块在打印时会保留深色底,否则 github-dark 的浅色文字会看不见const supported = ["色号", "题注", "图片魔法", "表格合并"];console.log(`已兼容 ${supported.length} 类语法`);GitHub 风格提示块:
TIP这类提示块由 remark-github-admonitions-to-directives 转换而来,与 VLOOK 的可折叠引用块可以共存。
12尚未实现的语法
以下 VLOOK 语法本站暂未支持,写了不会报错,但也不会有特殊效果,会按普通 Markdown 渲染:
- 页签组
_^页签组^_ - 明信片
#card/#cardd - 面包屑
- 表格冻结列、行分组折叠
- 数值列的货币格式(
¥/CNY)
这几项都需要额外的交互结构,使用频率也低于上面已实现的部分。如果实际写作中用到了,可以再补。
想收到新文章?
这个博客提供 RSS 全文订阅 —— 用阅读器订阅之后,新文章会自己送到你面前, 不用记得回来看,也不需要留邮箱、不用注册任何东西。
没用过 RSS 阅读器?常见的有 Feedly、Inoreader、NetNewsWire, 把上面的地址粘进去就行。