_VLOOK™
让你的 Markdown 有了新看^wán法
──
简介
最新版本V30.1

MAX°孟兆
COPYRIGHT © 2016-2025. MAX°DESIGN.

Select language ❯ English

VLOOK™ 是什么

开源中国 推荐的国产开源产品。

VLOOK™_T1 是针对 Typora¹ 主题包_GnRo 和 增强插件_PuOg，
属于开源软件（遵从 MIT License_Rd)。

编辑工具TyporaV1.9+_Gy　开源协议主MIT_Rd　关键字主题、插件_Pu　支持的操作系统Windows, macOS, Linux_Bu

• Typora 官方认可支持的主题包和增强插件，详见 Typora Support - Export

• OSCHINA (开源中国) 推荐的国产开源项目

合作资源：

许可协议

VLOOK™ 属于开源软件，遵从以下开源协议：

5
1
MIT License
2
Copyright (c) 2016-2025 MAX°DESIGN | Max Chow
3
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
5
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Markdown 是什么？

• 2004 年，John Gruber 创造了 Markdown，一种专门针对网络写作的 文本标记语言 。使用 Markdown，你只需在写作过程中插入少量的标记符号，就能很轻松地进行排版（例如设置标题、加粗、列表、引用块等）；

• Markdown 文档以 纯文本格式存储 ，这意味着，它们可以用几乎任一种文本编辑器打开。同时，又能通过 Markdown 编辑器导出为带排版的富文本文档、HTML 网页等等。纯粹、简洁、易用、灵活，都是人们喜欢 Markdown 的原因。

Markdown Logo

为谁准备

^tab

如果你也有以下一个或多个需求或痛点，就可以放心地尝试基于 Markdown 的文档解决方案进行文档的编辑、发布、管理，建议组合是 Typora + VLOOK™_BkGyT1T1T2

你是否也厌倦了 Markdown 文档千篇一律的排版和体验？VLOOK™ 在保持 Markdown 优雅的同时，还能让你编写的文档焕然一新。

在 文档排版、内容标记、内容导航、演示辅助、交互体验 等方面提供了 一致、简洁、友好 的体验。

只需简单几步的安装配置，你也可以拥有主题炫酷、排版丰富、交互友好的文档～

• 使用 Markdown 写文档，但对 Markdown 编辑器，或其输出的 HTML 的排版、交互有更多的需求

• 对于编写的文档，希望 ??? 统一模板与输出_T2 ，并且最好 ??? 随时切换不同模板_T2

• 希望只关注文档内容的撰写，内容编排、格式设置这种繁琐的排版工作希望能自动化完成

• 减少在文档（如：Word）、制图（如：Visio）等软件工具方面的购买支出，或是这些软件排版操作感觉厌烦

• 需要支持跨平台、跨终端进行文档浏览和文档发布方式

• 输出的文档能在阅读、评审、演示时，能提供交互辅助的工具（如目录/题注等内容索引、聚光灯、激光笔、脚注等）

💡 您知道吗？

AMAZING!!! 您正在浏览的这份文档，就是由 Typora 编辑并应用 VLOOK™ 主题与插件生成的～

_Bn!

打赏

感谢打赏支持 VLOOK™ 的客官（部分名单）

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

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

_Gn

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

_Bu

快速入坑

VLOOK™ 通过持续 挖掘和扩展 Markdown 和 CSS，同时结合了文档的互联网化应用场景～
在 文档排版、内容标记、内容导航、演示辅助、交互体验_GnOgSe 等方面提供了 一致、简洁、友好_PuOgRo 的体验。

简介视频

° 文档排版与内容标记

VLOOK™ 主题及插件，让你对 Markdown 编辑器（暂只支持 Typora）的自动化排版能力有了全新的理解和应用。

提供了丰富的文档排版、内容标识的能力外，还基于 HTML 格式让静态的文档也能与你一起「动」起来～

了解更多  范例参考

_Vn!

° 内容导航

VLOOK™ 提供了对文档内容、章节、插图、表格、多媒体多种形式的导航、快速定位和内容组织的工具，全面改善和提高发布的 HTML 文件的浏览体验和效率。

无多余动作，聚焦文档撰写。一键导出之时，即完成自动集成～

了解更多  范例参考

_Bu!

° 演示与出版

VLOOK™ 独创性地提供了强大的演示与出版工具，让 Typora + VLOOK 成为更具生产力的 Markdown 文档解决方案。

非常适合现场和远程的演示辅助工具，为你的文档开启 Turbo 模式～

了解更多  范例参考

_Og!

° 外观与不杂项

「人类从来都是视觉动物，自己或他人在阅读时，让眼睛感受愉悦和美好，是一种美德、一种力量、一种信仰。」

　　　　—— MAX°孟兆

 

了解更多  范例参考

_Lm!

专题文章

入选「知乎 • 海盐计划²」的专题文章 •• 点击前往看看

安装与使用

只需要三步，让你快速上车，开启不一样的 Markdown 体验之旅！_OgPuBu

准备工作

^tab

下载插件 ❯

从 GitHub 下载 从 Gitee 下载

配置 Typora ❯

1. 下载并安装 Typora 的最新版本

2. 打开菜单 Typora ▸ 偏好设置 ▸ Markdown

3. 启用 Markdown 扩展语法 和 代码块 下的所有选项。详见下图：

VLOOK™ 支持「离线」和「在线」两种安装模式，可同时安装配置，实际使用时再灵活选择～

🗳️ 离线模式

将主题和插件一并打包到生成的 HTML_Bu 中，适合没有自己的 Web 站点，或不依赖网络直接打开阅读的情况。

但单个 HTML 文件大小会相对较大，维护的文件数量较多时，更新管理的效率相对在线模式会低一些。

_T1

🌐 在线模式

将主题和插件先发布到自己的 Web 站点_Bu 上，适用于更大范围的内容发布，以及随时发布更新内容。

需要先准备 Web 站点（也可直接使用国外免费的 Pages 服务，如 CloudFlare、GitHub 所提供的 Pages 服务。

_T2

「离线模式」安装

安装主题包

^tab

添加主题 ❯

1. 打开目录 released/themes

2. 将该目录下所有 CSS 文件 复制至 Typora 的主题目录

Typora 的主题目录在哪？

打开菜单 Typora ▸ 偏好设置 ▸ 外观 ，点击 打开主题目录 定位到该目录

选用主题

1. 重启 Typora

2. 点击菜单 Typora ▸ 主题 ，选择以 Vlook *** 形式命名的任意主题即可（点这预览内置主题）

提交我的定制主题需求

了解 VLOOK™ 定制主题服务的更多信息

建议从范例文件开始你的写作

建议您参考或基于 VLOOK™ 的范例文档创建您自己的 Markdown 文档，这样可以更轻松做出排版质量更好的文档～

1. 在目录 released\samples 下的 .md 文件都是范例文件；

2. 也可直接在项目主页目录中下载：

下载范例 备用链接

配置导出选项

^tab

添加「导出设置」 ❯

1. 打开 Typora 导出配置

2. 打开菜单 Typora > 文件 > 导出 > 导出配置

3. 添加（选择 HTML 模板），并将配置命名为 VLOOK

安装「插件」 ❯

1. 首先，清空 在 <head /> 中添加 配置的内容

2. 打开插件文件：released/plugin/plugin.txt

3. 全选，并复制所有内容

4. 将复制的内容粘贴至 在 <head /> 中添加 配置内

一键导出为 HTML

1. 打开符合 VLOOK™ 规范的 md 文件（参考 released/samples 下的文件 ）

2. 点击菜单 Typora ▸ 文件 ▸ 导出 ▸ VLOOK 完成导出

「在线模式」安装

先完成你自己的 Web 站点搭建，然后进行以下资源的部署、站点域名调整等处理

^tab

配置在线主题

1. 安装在线主题：

   1. 用文本编辑器打开 released/themes-live 中需要使用的「在线版本」的主题文件（如 vlook-live-hope.css ）

   2. 搜索文件中所有 <your-host> 的内容，并替换为 Web 站点的域名

   3. 参考以上「安装主题包」的方式，将修改后的「在线版本」的主题文件复制到 Typora 的主题目录中

2. 部署主题文件到 Web 站点：

   1. 用文本编辑器打开 released/themes-live/res 中需要使用的主题文件（如 vlook-hope.css ）

   2. 搜索所有 <your-host> 的内容，并替换为 Web 站点的域名

   3. 将修改后的主题文件上传到 Web 站点的 res 目录下

配置网络字体

1. 部署网络字体到 Web 站点：

   1. 在 GitHub 上下载 openfonts 的最新版本（如：openfonts-V2.0.tar.gz）

   2. 解压后将里面的所有子目录（如：s v 上传至 Web 站点的 res 目录下

2. 引用网络字体：

   1. 用文本编辑器打开 released/plugin-live/res 下的所有以 fs- 开头的 css 文件

   2. 搜索所有 <your-host> 的内容，并替换为 Web 站点的域名

配置在线插件

1. 将 released/plugin-live/res 内的所有子目录、文件上传至 Web 站点的 res 目录下

2. 用文本编辑器打开 released/plugin/plugin-live.txt ，搜索所有 <your-host> 的内容，并替换为 Web 站点的域名

3. 涉及的配置项及说明如下：

   1. <link rel="preconnect" ...> — 预连接的服务器域名

   2. <link rel="dns-prefetch" ...> — （同上）

   3. <meta name="vlook-res-css" ...> — css 文件所在子目录的 URL

   4. <meta name="vlook-res-js" ...> — js 文件所在子目录的 URL

   5. <meta name="vlook-res-fs" ...> — 网络字体文件所在子目录的 URL

配置导出选项

参考以上「配置导出选项」操作，新建针对在线模式的导出配置，主要区别化处理内容如下：

1. 导出配置的命名建议增加 (live) 进行区分，如：VLOOK (live)

2. 需要粘贴的是「在线版插件」released/plugin/plugin_live.txt

语言包（可选）

VLOOK™ 的界面语言默认内置了 英文English_Se、中文简体_Rd ，对导出后的 HTML 需要支持更多语言，可以选择将对应语言包的内容，追加到以上导出配置中「元标签」内容的后面，重新导出 HTML 即可。

目前可扩展支持的语种：

法语Français_La 德语Detusch_Bk 俄语Русский_Bu 西班牙语Español_Ye 葡萄牙语Português_Wn
中文繁体_Rd 日语日本語_Gy 韩语한국어_Se 阿拉伯语العربية_Mn

「在线模式」会自动进行语言适配，而对于对于「离线模式」根据实际需要进行手工处理，具体如下：

^tab

1. 选择语言包 ❯

1. 语言包文件位于 released/plugin/lang 目录下

2. 打开一个或多个语言文件，并复制所有内容（如：Français.txt ）

2. 配置语言包

1. 首先，清空 在 <body /> 中添加 配置的内容

2. 打开 Typora > Preferences，并选择添加的导出配置 VLOOK

3. 将复制的内容粘贴到 在 <body /> 中添加 配置内

4. 若需要添加多个语言包，注意后续的语言包需要以「追加」的方式添加到配置项中

🧰 升级与兼容性

如何更新到最新版本？

若有新版本，在右下角会出现新版本升级提示图标 ，重复以上 安装与使用 中的步骤进行操作即要完成更新。

_Bu

推荐选择兼容的浏览器！

为保障最佳的使用体验，强烈建议使用以下浏览器访问：

Chrome　　 Edge　　 Firefox

_Bu

跨平台

使用 VLOOK™ 发布的 HTML 文档能自适应在台式机、平板、手机等多种设备不同屏幕和分辨率，提供最为合适的阅读和使用体验。

_La

动效

默认会启增强动效（包括毛玻璃），可以根据实际降低动效级别，可通过「插件调校参数」 effect 来进行调整

Firefox 如何启用毛玻璃效果？

如发现在 Firefox 浏览器中无法显示毛玻璃效果，可进行以下处理：

• 在地址栏输入： about:config

• 搜索配置项： layout.css.backdrop-filter.enabled ，并设置为 true

_La

增值服务

主题定制服务

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

了解更多定制主题的介绍

插件功能定制服务

针对你更个性的文档排版、交互、发布等方面需要，提供插件功能的定制服务～

💬 咨询沟通

排版编辑服务

针对你文档的内容、受众，充分应用 Typora + VLOOK™ 的众多特性，提供 文档排版、内容修订、知识库搭建、出版指导、Web 站点托管、发布 HTML 等服务。

了解更多增值服务的介绍

^tab

品牌周边

墙纸

与官方主题同款，附有 常用语法、色号 的参考

选择需要的分辨率版本

1336 × 768 1440 × 900 1920 × 1080 2560 × 1440 2560 × 1600

实物周边

与官方主题同款，附有 常用语法、色号 的参考

我要选购 - 鼠标垫

我要选购 - 桌面垫（键盘 & 鼠标垫)

讨论与交流

加入讨论与交流

💬 加入 QQ 群 (805502564) ✈️ 加入 Telegram 频道

用于测试不发布的内容

测试不发布章节

这些内容是不发布的！

货币列表格式示例

即将推出...

「在线模式」

为自建 Web 站点的用户提供完整的在线部署模式，可减少网络流量和提高页面加载响应速度～

咨询

_Bu!

「发布为 PDF」

为导出后的 HTML 文件提供导出 PDF 支持（已发布实验性版本），欢迎参与试用与反馈～

参与讨论

_Rd!

你有更多的特性建议？

欢迎前往我们在 GitHub 上的讨论组提出你的建议或期望能解决的痛点～

分享个点子

_Bn

用于测试最后一章不发布的内容

这些内容是不发布的！以及不会对 不存在的页内锚点 、外链 、不发布章节内的锚点 检查有效性的！

1
1
text

代码题注测试

3
1
title: 简介 - VLOOK™ - 优雅好用的 Typora 主题与增强插件
2
author: MAX°孟兆   
3
description: 关于 VLOOK™ 下载、设置、安装与配置配置说明

The End