Select language ❯ English

打赏

感谢打赏支持 VLOOK™ 的客官(部分名单)/ Thanks for donate VLOOK™ (partial donors)

PeterPuOgRd绿邃清幽CyBuAq李导996CyBuAqfankyCyBuAq*丽CyBuAq杨琛CyBuAq*哦GnBn*豫GnBnl*aGnBn*oGnBn、K*y、行川、*药、*山、*魂、*士、*狗、*R、*Z、*川、l*n、*朽、*杰、A*C、W*l、*山、J*o、韩宗辉、*星、一叶知秋、d*、*军、*鹏、*无、H*t、*二、*宇、*辉、*秋、*笑、*心、整*9、*国、*哥、乌拉、*龙、远方眼前、*雩、*应、*销、E*y、、…


你的咖啡,能让 VLOOK™ 保持活力 ☕️

打赏 VLOOK™

Gn

你的咖啡,能让 VLOOK™ 保持活力 ☕️

打赏 VLOOK™

Bu

°自动计算

列 A列 B列 C列 D列 E列 F
10022025-5-1  列 A 加总:=SUM(A1:A3)
200    A1*B1:=A1*B1
300    今天与 C1 的年数差:=DIFF(C1,YEAR(NOW())

°内容导航

文库导航

Markdown 粉Q以多个文档方式进行知识库管理时,希望能方便对所有发布后的 HTML 有效进行组织和连接。

VLOOKAT2 VLOOK™ 提供了灵活的「文库」组织功能,就可以随时链接直达你「文档宇宙」中的任意文档了。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

  • 在文档中配置了「文库」后(或文档中含有文库类型的链接时),在工具栏、目录大纲下方都会显示「文库」入口 字体风格 ,也支持直接通过快捷键 L 打开;

  • 支持为文库配置了多条链接;

  • 文库链接指向的页面默认是会在当前文档内以「文库弹窗」方式内嵌显示。

 

  1. 先为文档添加「YAML Front Matter」,菜单操作 Typora > 段落 > YAML Front Matter

  2. 然后在 YAML 内添加 vlook-doc-lib 配置项及对应的内容

 

根据需要选择以下任意一种或多种方式进行配置:

tab

文库配置方式一(最简化用法)

文库配置方式二(添加标题、搜索关键字)

 

若文档需要配置多个文库,可以参考以下分段的配置方式:

 

如何在浏览器「新标签页」中打开文库链接?

target 的取值与 HTML 标准一致,只需要设置为 _blank 或自定义,同时扩展支持 auto

示例如下:

如何在浏览器「当前标签页」中打开文库中的链接?

target 的取值与 HTML 标准一致,只需要设置为 _self 即可。

示例如下:

如何让文档中的任意链接也能在「文库弹窗」中显示?

只须设置文本链接是添加 URL 参数 target=vdl 即可。

示例如下:

更多示例效果,详见:链接内容识别

 

Tip

  • 文库链接与当前文档相同的不会重复出现在导航中心添加,有利于更灵活地对知识库多个文档的文库配置进行统一的模板化管理;

  • 当多个同类的文档都指定 target=_selft 时,可以实现文库链接与目录大纲融合显示的效果;

  • 更多关于通过 YAML Front Matter 设置插件预置选项的说明,详见 插件预置选项

导航中心

Markdown 粉Q文档涉及的内容多了之后,只有目录大纲的话无法快速定位和展示文档的关键资源、内容

VLOOKAT2 VLOOK™ 对导出的 HTML 除对目录大纲增强外,还支持丰富多样的文档资源的索引和管理。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

通过工具栏左侧的的 导航中心 导航中心按钮「收起/打开」导航中心(快捷键 N )。

Important

  • 基于 Typora 生成的目录大纲,请在文档中「VLOOK™ 的封面」后添加目录标记 [TOC]

  • 若文档无目录大纲和分类索引时,导航中心会默认收起;

  • 在桌面电脑端可将鼠标悬停在屏幕左侧的「导航指示器」打开,而在移动端 / 平板电脑端则直接点击。

逐章导航

Markdown 粉Q除了大纲外,希望可以按章节顺序一章一章进行浏览。

VLOOKAT2 由 VLOOK™ 接管后,会自动扩展提供「逐章导航栏」,正如你现在看到顶部的导航栏那样。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

当滚动至文档正文区后,会自动在顶部显示逐章导航条,在封面时会自动收起隐藏,支持对 1~5 级章节进行逐章浏览。

逐章导航快捷键

逐章导航的快捷键功能(逐章导航模式激活后生效)
, 前一个章节
. 后一个章节

插图导航

Markdown 粉Q希望能按图索骥,快速浏览文档中的所有插图,以及快速定位到文档中对应的位置。

VLOOKAT2 文档中的所有图片、Mermaid1 图表都支持快速浏览,一键跳转到对应位置。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 


  • 鼠标点击插图即可全屏显示,所有插图可支持通过在插图浏览器中打开,并进行前/后插图的导航;

  • 在插图浏览器中可点击插图直接定位到文档中对应的位置。

支持的插图类型:

  • 浏览器支持的所有图片(如:jpg / png / gif / bmp 等)

  • 脚本化图表(如:Mermaid1

插图导航快捷键

插图导航快捷键功能(打开插图导航后生效)
前一张插图
. 后一张插图
长图片与双题注示例

普通的图片示例(长图会自动折叠)

脚注导航

在技术、学术或论文类文档中,脚注的使用非常多。主要用于在页面底部对正文中的相关内容加以补充解释、注明参考文献出处、给出额外说明等。

VLOOK™ 可以直接在当前页面位置弹层的方式进行显示,避免在文档中来回跳转,也支持在 导航中心 直接跳转查看所有脚注。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

点击本段后的角标可以查看对应的脚注内容2

快捷操作导航

默认的操作项是导航历史

可通过在 YAML 中添加 vlook-quick-action 预置选项添加自定义的快捷操作项。

快捷操作导航配置分为「操作项图标」和「操作项链接」,并以英文分号 ; 进行分隔

操作项图标格式与 Markdown 图片语法一致,如:![图标标题](my-icon.svg) ,其中:

操作项链接格式与 Markdown 超链接语法一致,如:[备注说明](URL) ,其中:

配置举例如下:

 

 

需要配置多个快捷操作项时,可参考以下的分段配置方式:

 

继续上次的阅读

Markdown 粉Q一般发布的静态 HTML 文档,都无法记住上次阅读的位置~

VLOOKAT2 VLOOK™ 对导出的每一个静态 HTML ,都可以快速定位到上次阅读的位置。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

导航历史

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

 


如果你对以上内容有更多需求或建议,欢迎随时反馈~ Feedback via QQ Feedback via Telegram

°内容助手

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

针对不同形式的内容,提供自适应的快捷辅助功能。目前支持的内容形式包括:表格插图标签刮刮卡代码与代码块公式面包屑

Note

其中,鼠标悬停在以上所支持的内容上就会激活显示匹配的内容助手选项。

复制内容


插图全屏显示

支持通过内容助手对插图(图片、Mermaid 图片)一键全屏显示,并可进行前/后浏览翻阅,点这里试试看 ❯

表格阅读模式

Markdown 粉Q表格行、列很多时,希望能快速显示任意单元格相关的行、列都有哪些?

VLOOKAT2 无须高大上的设备或方式,VLOOK™ 激活后开箱即用~

  • 鼠标悬停在表格后,通过右上角内容助手上的 表格阅读模式 按钮打开、关闭;

  • 鼠标点击表格上的任意单元格后,会自动聚焦当前单元格及所在的行和列(类似于十字光标);

  • 支持通过方向键 )进行移动,对于 表格行分组折叠 的单元格,还可通过 Enter ⏎ 进行展开和收起;

  • 点击文档空白位置,或按下 ESC 临时取消显示。

试试点击表格的任意单元格,或让鼠标光标在以下表格行间进行移动
列 A列 B列 C列 D
第一行左对齐(长内容)居中对齐右对齐(长内容)
第二行(长内容)左对齐居中对齐(长内容)右对齐

换行版式

Markdown 粉Q在实际文档中会有各种「表格、代码块」,希望在阅读时可以根据需要指定不同换行、不行换行版式便于更好阅读浏览

VLOOKAT2 安排!VLOOK™ 激活后开箱即用~

鼠标悬停在「表格、代码块」后,通过右上角内容助手上的 换行版式 手工切换为「自动换行」或「不换行」

Note

VLOOK™ 会根据根据表格内容和屏幕宽度,自动适配认换行版式,具体详见 这里 ❯❯

画中画

Markdown 粉Q希望插图、表格、代码块、公式也能像视频那样,可以设置为「画中画」的浮动显示模式,方便在文档相关内容间对比

VLOOKAT2 这个可以有,VLOOK™ 激活后开箱即用~

  • 鼠标悬停在插图、表格、代码块、公式后,通过右上角内容助手上的 画中画 按钮一键开启;

  • 开启后默认缩小为 75% 大小进行显示,也可通过缩放按钮调整为原始大小进行显示。

快去文档中的任意插图、表格、代码块、公式上试试吧~


如果你对以上内容有更多需求或建议,欢迎随时反馈~ Feedback via QQ Feedback via Telegram

°演示辅助

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

激光笔

Markdown 粉Q在进行文档评审或演示时,可以通过 激光笔 来让观众注意力精确跟随演讲者指向的内容。

VLOOKAT2 无须高大上的设备或方式,VLOOK™ 激活后开箱即用~

通过工具栏上的 激光笔 按钮打开「聚光灯」(快捷键 P)。

聚光灯

Markdown 粉Q在进行文档评审或演示时,可以通过 聚光灯 来让观众聚焦于文档的特定区域和内容。

VLOOKAT2 无须高大上的设备或方式,VLOOK™ 激活后开箱即用~

  • 通过工具栏上的 聚光灯 按钮打开、关闭(快捷键 S );

  • 打开聚光灯后,可支持按通过 ⇧ Shift 键调节聚光灯的大小。

段落漫游

Markdown 粉Q希望在进行文档评审或演示时,按段落一段一段地突出,进行聚焦式浏览。

VLOOKAT2 点击工具栏上的段落漫游按钮 段落漫游 (或快捷键)就可以进入「段落漫游」模式了(致敬 vim)。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

段落漫游快捷键致敬 vim

快捷键功能
J跳到下一个段落
K跳到上一个段落
⌘ command / ⌃ Ctrl配合以上快捷键,可跳转 5 个段落
⇧ shift配合以上快捷键,可跳转 10 个段落

Mermaid 图表元素高亮

支持通过鼠标悬停的方式,对 Mermaid 图表中的关键元素(节点、子图、文本等)高亮显示,方便在演示场景下更聚焦说明的内容,点这里去找个 Mermaid 的图表试试 ❯

正文宽度适配

为保障阅读体验,默认情况下正文区域会与自动适应浏览器窗口的宽度,当宽度过大时进行提供:

Note

在 Typora 编辑时,以下情况下也会自动适配 Typora 的窗口宽度:


不显示左边的侧边栏(大纲/文件)

 

  • ⇧ Shift + Cmd / Control + L

启用专注模式(Focus Mode)

 

  • F8

阅读进度

在文档底部添加了友好的阅读进度显示,可以随时了当前阅读的进度,同时也不受滚动条是否自动隐藏的影响。

 

 


如果你对以上内容有更多需求或建议,欢迎随时反馈~ Feedback via QQ Feedback via Telegram

 

°出版辅助

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

标记不发布的内容

Markdown 粉Q在进行文档发布时,有些内容还未完成,或暂时不想显示,怎么优雅地处理?

VLOOKAT2 Markdown 的「删除线」和「标题」一拍即合,优雅地轻松驾驭文档发布的内容范围~

通过 Markdown 的「删除线」格式标记哪些内容暂不发布,支持以下内容:



指定的章节

1 级 ~ 6级章节标题,包括其下的子章节。

标记方式:只需将章节标题内容设置为删除线格式即可

指定的引用块

小标题折叠 的引用块

标记方式:只需将引用块的小标题、折叠标题内容设置为删除线格式即可

指定的表格列

指定的 1 列或多列

标记方式:参考 表格列格式,将列头设置为删除线格式即可



不发布的带加粗小标题的引用块

这是不发布的带加粗小标题的引用块

不发布的带高亮小标题的引用块

这是不发布的带加粗小标题的引用块

不发布的折叠引用块

这是不发布的折叠引用块

 

Tip

  • 对于不适合添加删除线的情况,也可以通过「插件预置选项」来指定;

  • 该特性可通过 定制主题 调整为不启用,也可以直接在删除线 ~~ 外添加空格来临时取消。

发布为 PDF

VLOOK™ 导出为 HTML 后,可以提供丰富的文档排版能力,但直接使用 Typora 的导出 PDF 功能会导致排版样式的丢失。
若需要以 PDF 格式发布,可通过 VLOOK™ 导出 HTML 后提供的「发布为 PDF」功能实现。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

  1. 打开导出的 HTML 文件后,通过右下角的 画中画 按钮( 快捷键 ⌃ Ctrl / ⌘ command + P )启动该功能;

  2. 打印前页面会针对打印输出进行样式的适配,并结合浏览器提供的「打印为 PDF / 另存为 PDF」功能最终实现发布为 PDF 文件;

  3. 默认情况下 PDF 会以一级标题进行分页,若有个性的分页规则,可以通过 定制主题 进行调整。

Tip

若默认的 PDF 分布无法满足个性化的需求,可以通过 定制主题 的方式提供个性化 PDF 发布的支持

 

社交分享

VLOOK™ 支持 Open Graph Protocol(是一个网络协议,用于在网页元数据中丰富内容的表示,尤其是在社交媒体上分享时),在分享时 VLOOK™ 会自动根据文档中预设的 OGP 标签内容生成网页分享到社交平台时的外观和描述。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

Important

  1. OGP 的标签与 VLOOK™ 的插件调校参数一样,都是通过文档中的 YAML Front Matter 来指定;

  2. 由于 OGP 的标签都含有冒号 : ,所以在 YAML Front Matter 中指定时须用英文的双引号进行包裹,如: "og:image": https://xxxxx.png

 

目前 VLOOK™ 导出配置已内置常见的 OGP 标签(详见下表),未在预置范围的标签可以自行在导出配置中添加。

支持以下常见的 Open Graph 标签

OGP 标签YAML 中的名称说明
og:title"og:title"网页的标题,这是分享时显示的主要标题
og:type"og:type"网页类型,如网站、视频、文章等
og:image"og:image"与网页相关联的图像,这是分享时显示的主要图片
og:url"og:url"网页的规范链接
其他常用标签====
> og:description"og:description"网页的简短描述,这通常在分享时显示
> og:site_name"og:site_name"网站的名称
> og:locale"og:locale"网页内容的区域设置或语言
> og:video"og:video"如果网页包含视频,这是视频的链接
> og:audio"og:audio"如果网页包含音频内容,这是音频的链接

在 YAML Front Matter 的应用举例

tab

Note

更多关于通过 YAML Front Matter 设置插件预置选项的说明,详见 插件预置选项

Tip

若需要验证发布到网络的 HTML 的 OGP 配置内容,除直接分享到社交工具外,也可通过 Meta for Developers 的 Sharing Debugger 工具进行预览

链接地图


外链清单及锚点数量

支持在当前文档中直接查看所有的外部链接清单,以及引用了这些链接的锚点数量(即链接中以 # 开头的内容)

外链锚点有效性检查

当维护的文档越来越多后,会存在未及时更新文档中外链锚点的情况,通过链接地图可快速对外链的锚点进行有效性检查

注意 外部链接的文档也需要由 VLOOK™ 插件生成

Tip

点击文档的右下角的 图标查看链接地图(快捷键 M ),并在链接地图中点击带有锚点条目后的「检查锚点」进行有效性检查

长内容自动折叠

VLOOK™ 会自动对文档中的长插图、长表格、长代码进行自动折叠,节省文档的屏幕显示空间~

Important

在引用块、引用块折叠内的图片、Mermaid 图表、表格、代码块等均不在长内容自动折叠范围内。

自定义欢迎页内容

Markdown 粉Q应用了 VLOOK™ 插件的文档在加载处理过程中会显示欢迎页,提示插件加载过程。但我希望能修改默认的欢迎信息。

VLOOKAT2 完成加载处理后会自动关闭并显示文档,若希望自定义欢迎页的显示行为也可以支持。

通过「插件预置选项vlook-welcome 来指定,在文档的 YAML Front Matter 区域添加以下内容:

自定义欢迎页内容示例

Note

更多关于通过 YAML Front Matter 设置插件预置选项的说明,详见 插件预置选项

链接失效与规范检查


图片源失效

自动识别无法加载的图片,并进行提示,示例:

Rd

音频、视频源失效

自动识别无法加载的音频视频,并进行提示,示例:

音频播放控件默认为标准模式

Rd



页内链接(锚点)不存在

自动检查当前页的页内跳转锚点,是否存在无效的情况,例如这条无效的页内链接

如何对外链锚点进行检查?详见链接地图 ❯❯

Rd

存在重复的章节标题

为避免无法跳转到该章节处

(可通过插件预置选项 vlook-header-dup 指定允许可重复的标题)

Ye

链接锚点规范检查与修正

检查文字链接的锚点是否使用了标点符号,并进行自动修正处理

Gy

Warning

  • 存在需要关注或处理建议的异常结果时,会在文档的右下角显示 图标提示,点击可查看具体的异常信息;

  • VLOOK™ 对图片、多媒体资源采用「懒加载」模式,具体资源地址异常情况需要页面滚动到对应位置后才会触发检查。

链接内容识别

VLOOK™ 主题会自动识别文档中的超链接内容类型,显示不同的鼠标光标(鼠标光标样式同样适配 Light / Dark Mode)

VLOOK™ 主题专属鼠标光标



VLOOK™ 文库专属链接

T1!

识别主流超链接资源

#页内链接 / 非安全链接 / 安全链接 / 邮件

Gy!

高风险资源

.exe 文件 / .sh 文件

Rd!

链接内容转换


自动转换 md 链接

在 Typora 支持在编辑时指定为任意 md 文档(或带锚点的 md 文件),方便在多文档维护时随时跳转,但导出 HTML 后不会自动转为 html,这对不适用于基于 HTML 发布的场景。

默认支持将文档中的 *.md 链接转换为 html ,也可以指定为任意的扩展名。

若希望关闭该自动转换,或指定转换的扩展名,可通过「插件调校参数xmd 进行调整。

Bu!

外部链接强制在新标签打开

为提高文档阅读与交互体验,对于外链(如:http、https等),自动强制设置为在新标签页中打开。

Vn!

图片懒加载模式

Markdown 粉Q对于文档中图片数量较多时,导出 HTML 后默认都为立即加载,影响文档打开速度和导致不必要的网络资源占用。

VLOOKAT2 支持对文档中的图片资源启用延时加载,只有在页面滚动到图片所在位置才会显示。

如何开启延时加载?

零操作!只需要使用 VLOOK™ 内置的主题 或 定制主题,正常配置并导出为 HTML 后即可具备该特性!

字数与阅读时长

在文档右下角显示当前文档的字数统计(区分拉丁、中日韩字数),以及阅读时长的参考。

 


如果你对以上内容有更多需求或建议,欢迎随时反馈~ Feedback via QQ Feedback via Telegram

°外观

模板主题

Markdown 粉Q你的 Markdown 文档能一键换肤吗?!

VLOOKAT2 内置了多套原创、独具气质的模板主题,能满足多种应用场景需要,完全超越你对 Markdown 主题的印象!

适用范围 ••• 编辑时✓ 支持Gn 导出 HTML✓ 支持Gn

主题会应用到 Typora 的应用程序 UI,以及文档内各类可编辑的元素,尽可能达到从整体到细节的视觉一致性!

预置的模板主题

VLOOK™ 内置的 6 套免费主题(点击下图可预览效果)~



灵感来自于电影《Titanic 泰尼克号》,字体风格默认为「文艺范」

Bu

灵感来自于中国的古建筑与现代化工业风的融合

Ye

极客改变世界,VLOOK 也改变了 Markdown 排版自动化的玩法

Gy



灵活来自我喜欢的咖啡时光,字体风格默认为「小清新」

Og

灵活来自冥想与禅思

Cy

致敬由 Sun Microsystems 研发的计算机操作系统 Solaris,字体风格默认为「Book」

Vn

定制模板主题

目前现已开放主题的「定制服务」,以下为部分定制案例参考

定制主题

 

去探索更多定制主题的介绍

字体风格

Markdown 粉Q模板主题让文档颜值倍增,而字体则是文档气质担当!

VLOOKAT2 提供了 8 套独特个性的字体风格,可根据个人喜好进行选用。

适用范围 ••• 编辑时✓ 支持Gn 导出 HTML✓ 支持Gn

 

通过右下角状态栏上的 字体风格 按钮进行选择(快捷键 A )
也支持通过「定制主题」进行预置指定




使用系统的 UI 字体,在不同的系统或终端上会效果会稍有不同

Gy

用系统内置的宋体、黑体进行「混搭」,在不同的系统或终端上会效果会稍有不同

Gy

整体表现为「禅院、正楷书法、宁静空间」(需要浏览器加载网络字体或下载安装)

Gy

整体表现为「亲和力、温润、健康」(需要浏览器加载网络字体或下载安装)

Gy




整体表现为「活力、开放」(需要浏览器加载网络字体或下载安装)

Gy

整体表现为「优雅、韵动、个性」(需要浏览器加载网络字体或下载安装)

Gy

整体表现为「清新、简约、潮流」(需要浏览器加载网络字体或下载安装)

Gy

整体表现为「童趣、手写、随心、惬意」(需要浏览器加载网络字体或下载安装)

Gy

 

其中部分带有 (WebFont) 标记的字体风格须连接互联网才能正常加载和生效。若无法连接网络或网络速度较慢,建议下载字体在本地进行安装。

下载字体包

Note

  • 可以选择所需要使用的字体风格的字体包进行安装,也可以全部安装;

  • 部分字体在不同字体风格中会有重复,安装时若提示已存在,可以跳过对应字体的安装。

Important

设置后同一域名下所有文档都会进行应用,也可通过「插件调校参数font 来强制指定文档使用的字体风格。

 

Dark Mode

Markdown 粉Q希望 Markdown 的文档能适配系统的深色模式,保持良好、一致的体验~

VLOOKAT2 所有 VLOOK™ 的主题都会自动根据浏览器或系统的 Dark Mode(深色模式)的设置进行自动适配。

适用范围 ••• 编辑时✓ 支持Gn 导出 HTML✓ 支持Gn

 

可通过右下角状态栏上的 Auto Mode / Light Mode / Dark Mode 按钮进行手动切换(快捷键 D )

 

Note

  • 设置后同一域名下的所有文档都会应用该配置,也可通过「插件调校参数cs 来强制指定使用的字体风格(只对指定的文档生效);

  • 若不希望自动根据系统的设置自动切换为 Dark Mode,可以通过 定制主题 的方式来实现。

Light / Dark 效果预览

Tip

如果你的图片在 Dark Mode 下显得不够和谐,可以尝试选择让 图片适配 Dark Mode

Gray Mode

Markdown 粉Q希望在国家公祭日,或其它指定的日期进行浏览时,能自动变为灰色显示~

VLOOKAT2 在 VLOOK™ 中可以轻松支持任意一个或多个在指定日期时以灰色显示。

适用范围 ••• 编辑时× 不支持Gy 导出 HTML✓ 支持Gn

 

通过「插件预置选项vlook-gray-mode 来指定启用 Gray Mode 的日期,该内容在文档的 YAML Front Matter 区域进行添加

增补以 Gray Mode 显示的日期

表示月份, 表示日期。如: 12-1304-05

标题 可选,对该日期的说明。如:国家公祭日

语言代码 可选,该日期适用的语言,如适用多种语言可写在一起,以英文逗号分隔

如:中文zh 、中文和韩文 zh,ko 、英语 en


 

  • 若指定多个日期,每个日期间以英文分号 ; 进行分隔

  • 如果需要临时恢复当前文档正常显示,可以通过状态栏上的 Gray Mode 按钮进行操作

tab

Important

VLOOK™ 面向中文语言用户内置了在「中国国家公祭日、清明节」时启用 Gray Mode 的设定

Note

更多关于通过 YAML Front Matter 设置插件预置选项的说明,详见 插件预置选项

浏览器主题色

支持移动端的浏览器顶部的主题色(品牌色)特性,获得更好友、一致的浏览体验。

具体浏览器对 theme-color 的支持不同平台和版本会有区别,目前支持该标准的主流浏览器包括:

 


如果你对以上内容有更多需求或建议,欢迎随时反馈~ Feedback via QQ Feedback via Telegram

°不杂项

插件预置选项

通过 YAML Front MatterVLOOK™ 预置选项进行设置:

  1. 首先,为文档添加 YAML 内容(菜单:Typora ▸ 段落 ▸ YAML Front Matter);

  2. 然后对指定预置选项进行设置,格式举例如下:

通过 YAML 设置 VLOOK™ 插件预置选项

插件预置选项[]支持预置到
定制主题
简介内容取值及说明
YAML 标准选项 YAML Front Matter 的标准选项 
> title 标题 
> author 作者 
> keywords 关键字 
vlook-doc-lib 启用并指定当前文档的文库 URL支持指定多个,详见:文库导航
vlook-gray-mode 设置启用 Gray Mode 的日期详见:Gray Mode
vlook-header-autonumY标题自动编号的格式、前缀、后缀等内容详见:标题自动编号
所有分级的章节都不进行自动编号,可通过定制主题关闭该特性
vlook-header-dup 指定允许重复的章节标题内容• 在对文档章节标题查重时指定的内容
• 支持正则表达式
(以字面量方式进行定义,如 /pattern/flags
多个内容间以英文分号 ; 进行分隔
vlook-image-host 默认图床地址目前主要针对 Safari 打开本地 HTML 的文件,且指定图片剪影时使用
如: https://xxx.abc.com/images
vlook-welcome 自定义文档在加载时欢迎页信息详见:自定义欢迎页内容
vlook-queryY预置 VLOOK™ 规范的插件调校参数详见以下章节:插件调校参数
vlook-unpub 指定不发布的内容支持正则表达式
(以字面量方式进行定义,如 /pattern/flags
多个内容间以英文分号 ; 进行分隔

插件调校参数

通过 VLOOK™ 的「插件调校参数」可以对插件功能或文档的样式、交互方式进行开关和调整,支持以下方式进行调校(若同时存在则以 URL 参数指定的为优先):

tab

方式一:通过 URL 参数指定插件调校参数

方式二:通过 YAML 指定插件调校参数

 

VLOOK™ 插件调校参数说明

调校参数说明默认值取值及说明
排版   
> badge调整 多级标签 未指定色号时默认使用的色号T1色号 - 对应的预置色号,详见这里
> coating调整 刮刮卡 未指定色号时默认使用的色号Gy色号 - 对应的预置色号,详见这里
> quote调整普通的「引用块」默认自动转换为指定色号的 引用块着色offoff - 关闭,不自动转换
色号 - 对应的预置色号,详见这里
> tag调整 标签 未指定色号时默认使用的色号T2对应的预置色号,详见这里
题注   
> capgroup题注的自动编号是否按所属章节进行分组编号onoff - 不开启
on - 开启
> capblank未指定题注内容时是否添加空白题注
须配合定制主题才能生效
off指定范围开启:
codeblock - 代码块
页签组   
> tabcap页签组的页签上是否显示题注编号(如:表 1-2)offoff - 不显示
on - 显示
> tabico指定页签上显示的内容分类图标样式lineoff - 不显示
line - 线性样式
solid - 单色样式
flat - 分层样式
外观   
> cs指定使用固定的颜色方案autolight - 强制显示为 Light Mode
dark - 强制显示为 Dark Mode
auto - 自动跟随系统配置
> fillw指定正文宽度适配可显示宽度的默认状态offoff - 关闭
on - 开启
> font强制指定使用的字体风格
指定该参数后则忽略 VLOOK 主题配套的字体风格
themetheme 使用主题配套
local - 系统默认
book - 书香里
dyn - 活力派
zen - 禅意斋
sans - 小清新
serif - 文艺范
> gray指定是否启用 Gray Modeonoff - 关闭
on - 开启
force - 强调开启,用于预览效果
> radius强制使用指定的圆角样式,忽略 VLOOK 主题自带的样式 none - 不使用圆角
small - 使用小号圆角
big - 使用大号圆角
> sts指定状态栏的默认显示方式showhide - 隐藏
show - 显示
> uico指定插件界面的图标样式solidsolid - 单色样式
flat - 分层样式
交互   
> tr指定表格阅读模式(十字光标)默认开关offoff - 不开启
on - 开启
> ws指定文档的「欢迎页」显示模式autoauto - 页面加载完成后自动关闭欢迎页
wait - 文档和插件加载完成后,手动关闭欢迎页
off - 不显示欢迎页
1~60 - 指定延时等待的秒数
发布   
> unpub标记为不发布内容 进行处理的开关onoff - 不开启
on - 开启
> xmd指定将扩展名为「*.md」的链接转换为指定的新扩展名
(默认对全局生效,也支持在文本链接中单独指定)
htmloff - 关闭,不转换
{扩展名} - 指定的扩展名,如 php htm
> pdf对导出后的 HTML 开启「发布为 PDF」的功能onoff - 不开启
on - 开启
导航中心   
> nav指定导航中心初始的运行模式autoauto - 在封面时自动收起、在正文时自动展开
hide - 默认收起
> toc指定目录大纲初始自动折叠的层级10 - 不折叠,全部展开
1~5 - 折叠指定的层级
> vdl控制文库功能的开关onoff - 不开启
on - 开启
调试   
> reset强制重置浏览器存储的 VLOOK 相关数据 true
> tab强制控制页签组排版特性的启用或停用onoff - 停用
on - 启用

快捷键操作

VLOOK™ 的功能和特性支持快捷键操作,效率再上一个台阶。

快捷键操作汇总

分类功能快捷键
常用开启、关闭 Dark ModeD
:显示、隐藏「导航中心」面板N
:搜索导航中心的内容/
:打开「文库」,或显示入口L
:打开「链接地图M
:打开「异常链接 / 地址E
:打开「导航历史」H
:发布为 PDF⌘ command / ⌃ Ctrl + P
页签组切换显示下一个页签内容tab
:切换显示上一个页签内容⇧ Shift + tab
表格阅读模式移动当前聚焦单元格
:展开/收起 表格行分组Enter ⏎
字体风格选择字体风格A
:退出「字体风格」选择ESC
逐章导航前一个章节 ,
:后一个章节 .
段落漫游打开「段落漫游」JK
:跳到下一个段落J
:跳到上一个段落K
:配合以上快捷键,可跳转 5 个段落⌘ command / ⌃ Ctrl
:配合以上快捷键,可跳转 10 个段落⇧ shift
:退出「段落漫游」模式ESC
插图导航显示「插图导航」I
:前一张插图 ,
:后一张插图 .
:退出「插图导航」模式ESC
聚光灯打开「聚光灯」S
:调节聚光灯的大小⇧ Shift
:退出「聚光灯」模式ESC
激光笔打开「激活笔」P
:退出「激光笔」模式ESC

如果你对以上内容有更多需求或建议,欢迎随时反馈~ Feedback via QQ Feedback via Telegram

延伸内容

章节标题内容注意事项

  1. 标题内容原则上不要带有标点符号(如: _ 等)

    1. 如果必须保留,在设置文字链接跳转至该标题时忽略这些标点符号

    2. 如标题内容为「标题、标题?」,则文字链接跳转应写成: 标题标题

  2. 标题内容原则上不要带有空格,如果有请替换为连字符 -

图片地址扩展应用说明

tab

图片地址无 Query 参数时

  • 先在 URL 后添加英文问号 ? 后,再添加需要的 URL Query 参数;

  • 当图片地址已有 Query 参数时,多个参数间用英文特殊符号 & 进行分隔。

示例-1:![图片题注](xxx.png?darksrc=invert)

示例-2:![图片题注](xxx.png?darksrc=invert#icon)

Important

若图片地址中含有锚点内容,如 xxx.png#icon ,URL Query 参数须在锚点前添加。

图片地址锚点

  • 图片地址支持添加锚点「#魔法」实现快速图片排版,目前支持通过锚点排版的特性详见:°图片

  • 当需要同时应用以上多个排版,可添加多个锚点,如: #card#fixmax

基于色轮的配色方案

配色示例说明
单色方案单色方案
由一个颜色的暗/中/明色调组成(如:暗绿、绿、粉绿)

单色搭配上并没有形成颜色的层次,但形成了明暗的层次。
这种搭配在设计中应用时,出来的效果永远不错,其重要性也可见一斑。
类比色方案类比色方案
色轮上某个颜色的相邻的颜色(如:橙黄色、黄色、橙色)

类比色都拥有共同的三原色颜色(在上图中,是黄色及红色)。
这种颜色搭配产生了一种令人悦目、低对比度的和谐美感。
类比色非常丰富,在设计时应用这种搭配同样让你轻易产生不错的视觉效果。
补色方案补色方案
色轮上直线相对的两种颜色(如:红、绿)

补色形成强列的对比效果,传达出活力、能量、兴奋等意义。
补色要达到最佳的效果,最好是其中一种面积比较小,另一种比较大。
比如在一个蓝色的区域里搭配橙色的小圆点。
分裂补色方案分裂补色方案
色轮上某颜色(如:红色)及其补色的类比色(如:绿、青)

这种颜色搭配既具有类比色的低对比度的美感,又具有补色的力量感。
形成了一种既和谐又有重点的颜色关系。
如在上面三种颜色中,红色就显得更加突出。
二次色方案二次色方案
二次色容易构成协调的搭配(如:绿、橙、紫)

任意两个二次色之间都拥有一种共同的颜色,所以它们轻易能够形成协调的搭配。
如果三种二次色同时使用,则显得很舒适、吸引,具有丰富的色调,以及深度和广度。
原色方案原色方案
三原色同时使用是比较少

红黄搭配较受欢迎。从快餐店到加油站,我们都可以看见这两种颜色同时在一起。
蓝红搭配也很常见,但只有当两者的区域是分离时,才会显得吸引人。
注意:如果是紧邻在一起,则会产生冲突感,需进行分离。

1 Mermaid is JavaScript based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify diagrams dynamically.
2 这是 VLOOK™ 优化后的脚的信息