1212 字
6 分钟
VLOOK 语法兼容测试
TL;DR

逐项列出本站已支持的 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 注音:漢字(hàn zì)拉麵(rā miàn)

5按钮链接#

<kbd> 包在链接文字里,就会渲染成按钮:

下载示例文件

查看源码

6进度条#

**==75%==** 会画成带轨道的进度条:

项目完成度 75%

测试覆盖率 42%

磁盘占用 93%

7刮刮卡#

*提示**内容*** 会把内容遮住,点击或按回车揭开:

这道题的答案是 42

隐藏的密钥是 hunter2

8可折叠引用块#

引用块首行写成六级标题,整块就可折叠:

点开看详细说明

折叠块适合放长篇的补充说明、报错日志、可选步骤这类内容 —— 需要的人能看到,不需要的人不会被淹没。

里面可以放多个段落,也可以放列表:

  • 第一项
  • 第二项

9图片魔法#

在图片路径末尾加锚点即可控制排版。这些锚点会在渲染时被剥离,不会真的发到请求里。

9.1缩放#

#40%#400w#200h 分别按比例、按宽度、按高度缩放。

按宽度缩放到 400px

图 1按宽度缩放的示例图

9.2形状与边框#

#round 圆角、#border 描边、#padding 内边距。

圆角加描边

图 2圆角与描边的示例图

9.3滤镜#

#gray 灰度、#blur 模糊、#aged 做旧、#invert 反色。末尾加 ! 表示鼠标悬停时恢复原样。

灰度,悬停恢复

图 3灰度滤镜,鼠标移上去会恢复原色

9.4翻转#

#180deg 旋转、#fliph 水平翻转、#flipv 垂直翻转。

水平翻转

图 4水平翻转的示例图

10表格增强#

10.1单元格合并#

单元格内只写 == 表示向左合并,只写 : 表示向上合并。

区域第一季度第二季度备注
华东1200前两列已合并
华南860940正常两格
730810首列向上合并
图 5横向与纵向合并的效果

10.2列格式与数值#

表头加粗让整列加粗,表头加删除线让该列不输出到页面;列设为右对齐时,数字会自动加千分位、缩小小数、给正负号着色,百分比还会带一条进度条。

名称重点列金额同比
甲方案首选1,234,567+12.5%
乙方案备选-8,900.25-3.2%
丙方案待定45,60078%
图 6数值列自动格式化,删除线列已被剔除

11与既有功能共存#

VLOOK 语法不影响本站原有的 Markdown 能力,下面几项照常工作。

行内公式 E=mc2E = mc^2 与块级公式:

0ex2dx=π2\int_0^\infty e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}

代码高亮:

// 代码块在打印时会保留深色底,否则 github-dark 的浅色文字会看不见
const supported = ["色号", "题注", "图片魔法", "表格合并"];
console.log(`已兼容 ${supported.length} 类语法`);

GitHub 风格提示块:

TIP

这类提示块由 remark-github-admonitions-to-directives 转换而来,与 VLOOK 的可折叠引用块可以共存。

12尚未实现的语法#

以下 VLOOK 语法本站暂未支持,写了不会报错,但也不会有特殊效果,会按普通 Markdown 渲染:

  • 页签组 _^页签组^_
  • 明信片 #card / #cardd
  • 面包屑
  • 表格冻结列、行分组折叠
  • 数值列的货币格式(¥ / CNY

这几项都需要额外的交互结构,使用频率也低于上面已实现的部分。如果实际写作中用到了,可以再补。

VLOOK 语法兼容测试
作者
xhc861
发布于
2026-08-09
许可协议
CC BY-NC-SA 4.0

评论区

请添加歌曲
前往右上角设置按钮添加