设置
VMark 的设置面板让你可以自定义编辑器的方方面面。使用 Mod + , 或通过菜单栏中的 VMark > 设置 打开。
设置窗口的侧边栏按主题分组列出各章节 —— 最常用的章节在前，"关于"和"高级"在底部。更改立即生效 —— 没有保存按钮。
外观
控制视觉主题和窗口行为。
主题
从五种颜色主题中选择。活动主题以其色块周围的圆环标示。
| 主题 | 背景色 | 风格 |
|---|---|---|
| White | #FFFFFF | 简洁、高对比度 |
| Paper | #EEEDED | 温暖中性色（默认） |
| Mint | #CCE6D0 | 柔和绿色，护眼 |
| Sepia | #F9F0DB | 温暖米黄色，书本感 |
| Night | #23262B | 深色模式 |
语言
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 语言 | 更改菜单、标签和消息的界面语言，立即生效 | English | English、简体中文、繁體中文、日本語、한국어、Español、Français、Deutsch、Italiano、Português (Brasil) |
窗口
| 设置 | 描述 | 默认值 |
|---|---|---|
| 在标题栏显示文件名 | 在 macOS 窗口标题栏显示当前文件名 | 关闭 |
| 自动隐藏状态栏 | 不与状态栏交互时自动隐藏 | 关闭 |
编辑器
排版、显示、编辑行为和空白字符设置。
排版
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 拉丁字体 | 拉丁文（英文）字体族 | 系统默认 | 系统默认、Athelas、Palatino、Georgia、Charter、Literata |
| 中日韩字体 | 中文、日文、韩文字体族 | 系统默认 | 系统默认、PingFang SC、Songti SC、Kaiti SC、Noto Serif CJK、Source Han Sans |
| 等宽字体 | 代码和等宽文本的字体族 | 系统默认 | 系统默认、SF Mono、Monaco、Menlo、Consolas、JetBrains Mono、Fira Code、SauceCodePro NFM、IBM Plex Mono、Hack、Inconsolata |
| 字号 | 编辑器内容的基础字号 | 18px | 14px、16px、18px、20px、22px |
| 行高 | 行间垂直间距 | 1.8（宽松） | 1.4（紧凑）、1.6（正常）、1.8（宽松）、2.0（宽敞）、2.2（超宽） |
| 块间距 | 块级元素（标题、段落、列表）之间的视觉间距，以行高的倍数计算 | 1x（正常） | 0.5x（紧凑）、1x（正常）、1.5x（宽松）、2x（宽敞） |
| 中日韩字符间距 | 中日韩字符之间的额外间距，以 em 为单位 | 关闭 | 关闭、0.02em（微妙）、0.03em（轻微）、0.05em（正常）、0.08em（宽）、0.10em（更宽）、0.12em（超宽） |
显示
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 编辑器宽度 | 最大内容宽度。较大的值适合大显示器；较小的值提高可读性 | 50em（中等） | 36em（紧凑）、42em（窄）、50em（中等）、60em（宽）、80em（超宽）、无限制 |
TIP
18px 字号下的 50em 约为 900px —— 对大多数显示器来说是舒适的阅读宽度。
行为
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| Tab 大小 | 按 Tab 时插入的空格数 | 2 个空格 | 2 个空格、4 个空格 |
| 启用自动配对 | 输入开括号时自动插入对应的闭括号和引号 | 开启 | 开启/关闭 |
| 中日韩括号 | 自动配对中日韩专用括号如 「」 【】 《》，仅在启用自动配对时可用 | 自动 | 关闭、自动 |
| 包含弯引号 | 自动配对 "" 和 '' 字符，可能与某些输入法的智能引号功能冲突，当中日韩括号设为"自动"时显示 | 开启 | 开启/关闭 |
同时配对 " | 输入右双引号 " 时也插入 "" 配对，当你的输入法在开闭引号之间交替时很有用，启用弯引号时显示 | 关闭 | 开启/关闭 |
| 复制格式 | 从所见即所得模式复制时，纯文本剪贴板槽使用的格式 | 纯文本 | 纯文本、Markdown |
| 选中即复制 | 选中文本时自动复制到剪贴板 | 关闭 | 开启/关闭 |
空白字符
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 保存时的行尾符 | 控制保存文件时如何处理行尾符 | 保留现有 | 保留现有、LF (\n)、CRLF (\r\n) |
| 保留连续换行 | 保持多个空白行，而不是合并 | 关闭 | 开启/关闭 |
| 保存时的硬换行样式 | 硬换行在保存的 Markdown 文件中的表示方式 | 保留现有 | 两个空格（推荐）、保留现有、反斜杠（\） |
显示 <br> 标签 | 在编辑器中可视化显示 HTML 换行标签 | 关闭 | 开启/关闭 |
TIP
两个空格是兼容性最好的硬换行样式 —— 在 GitHub、GitLab 和所有主流 Markdown 渲染器上均有效。反斜杠样式在 Reddit、Jekyll 和某些旧版解析器上可能失效。
Markdown
粘贴行为、布局和 HTML 渲染设置。
粘贴与输入
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 在搜索中启用正则 | 在查找与替换栏显示正则切换按钮 | 开启 | 开启/关闭 |
| 粘贴模式 | VMark 如何路由剪贴板中的内容 | 智能 | 智能、纯文本 |
| 所见即所得中粘贴 Markdown | 向所见即所得编辑器粘贴看起来像 Markdown 的文本时，自动转换为富文本内容 | 自动 | 自动、关闭 |
布局
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 块元素字号 | 列表、引用块、表格、提示块和详情块的相对字号 | 100% | 100%、95%、90%、85% |
| 标题对齐 | 标题的文本对齐方式 | 左对齐 | 左对齐、居中 |
| 图片和图表边框 | 是否在图片、Mermaid 图表和数学块周围显示边框 | 无 | 无、始终、悬停时 |
| 图片和表格对齐 | 块图片和表格的水平对齐方式 | 居中 | 居中、左对齐 |
Lint
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 启用 Markdown 检查 | 检查常见 Markdown 问题（损坏的链接、缺少 alt 文本、标题层级跳跃、未关闭的代码围栏等） | 开启 | 开启/关闭 |
完整规则列表和严重级别请参阅 Markdown 检查。
HTML 渲染
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 所见即所得中的原始 HTML | 控制是否在所见即所得模式下渲染原始 HTML 块 | 隐藏 | 隐藏、净化、净化 + 样式 |
TIP
隐藏 是最安全的选项 —— 原始 HTML 块折叠且不渲染。净化 在去除危险标签后渲染 HTML。净化 + 样式 额外保留内联 style 属性。
文件与图片
文件浏览器、保存、文档历史、图片处理和文档工具。
文件浏览器
这些设置仅在打开工作区（文件夹）时有效。
| 设置 | 描述 | 默认值 |
|---|---|---|
| 显示隐藏文件 | 在文件浏览器侧边栏中显示点文件和隐藏系统项 | 关闭 |
| 显示所有文件 | 在文件浏览器中显示非 Markdown 文件，非 Markdown 文件会用系统默认应用打开 | 关闭 |
退出行为
| 设置 | 描述 | 默认值 |
|---|---|---|
| 确认退出 | 需要按两次 Cmd+Q（或 Ctrl+Q）才能退出，防止意外退出 | 开启 |
保存
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 启用自动保存 | 编辑后自动保存文件 | 开启 | 开启/关闭 |
| 保存间隔 | 自动保存之间的时间，仅在启用自动保存时可用 | 30 秒 | 10 秒、30 秒、1 分钟、2 分钟、5 分钟 |
| 保留文档历史 | 跟踪文档版本以便撤销和恢复 | 开启 | 开启/关闭 |
| 最大版本数 | 每个文档保留的历史快照数量 | 50 个版本 | 10、25、50、100 |
| 保留版本时长 | 历史快照在被清除前的最长保存时间 | 7 天 | 1 天、7 天、14 天、30 天 |
| 合并窗口 | 此时间窗口内的连续自动保存合并为单个快照，减少存储噪音 | 30 秒 | 关闭、10 秒、30 秒、1 分钟、2 分钟 |
| 历史的最大文件大小 | 超过此阈值的文件跳过历史快照 | 512 KB | 256 KB、512 KB、1 MB、5 MB、无限制 |
图片
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 粘贴时自动调整大小 | 保存到资产文件夹前自动调整大图片。值为最大像素尺寸 | 关闭 | 关闭、800px、1200px、1920px（全高清）、2560px（2K） |
| 复制到资产文件夹 | 将粘贴或拖放的图片复制到文档的资产文件夹，而不是嵌入 | 开启 | 开启/关闭 |
| 关闭时清理未使用的图片 | 关闭文档时自动删除资产文件夹中不再被引用的图片 | 关闭 | 开启/关闭 |
| 内联图片阈值 | HTML/PDF 导出中以 base64 数据 URL 内嵌图片的最大大小（MB），更大的文件改为以链接方式引用 | 1.0 MB | 0.1 – 10 MB |
大文件
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 大于此大小时警告 | 打开超过此大小的文件时显示确认提示 | 5 MB | 开启/关闭 |
| 自动源码模式 | 自动以源码模式打开超过阈值的文件（跳过所见即所得以保持流畅性能） | 开启 | 开启/关闭 |
大文件的完整处理方式请参阅大文件。
更新
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 检查频率 | 何时检查 VMark 新发布版本 | 启动时 | 启动时、每天、每周、手动 |
| 自动下载更新 | 检测到更新后在后台下载发布制品 | 关闭 | 开启/关闭 |
| 跳过版本 | 抑制对特定版本的更新提示（在提示自身上按更新设置） | 无 | — |
TIP
如果你经常粘贴截图或照片，请启用 粘贴时自动调整大小 —— 它无需手动调整即可保持资产文件夹轻量。
文档工具
VMark 检测 Pandoc 以支持导出为其他格式（DOCX、EPUB、LaTeX 等）。点击 检测 扫描你系统上的 Pandoc。找到后会显示其版本和路径。
所有导出选项的详情请参阅导出与打印。
集成
MCP 服务器和 AI 提供商配置。
MCP 服务器
MCP（模型上下文协议）服务器允许外部 AI 助手（如 Claude Code 和 Cursor）以编程方式控制 VMark。
| 设置 | 描述 | 默认值 |
|---|---|---|
| 启用 MCP 服务器 | 启动或停止 MCP 服务器。运行时，状态徽章显示端口和已连接的客户端 | 开启（切换） |
| 启动时自动启动 | VMark 打开时自动启动 MCP 服务器 | 开启 |
| 自动批准编辑 | 不显示预览确认，直接应用 AI 发起的文档更改，请谨慎使用 | 关闭 |
服务器运行时，面板还会显示：
- 端口 —— 自动分配；AI 客户端通过配置文件发现端口
- 版本 —— MCP 服务器附属程序版本
- 工具/资源 —— 可用的 MCP 工具和资源数量
- 已连接的客户端 —— 当前连接的 AI 客户端数量
在 MCP 服务器部分下方，你可以一键将 VMark 的 MCP 配置安装到支持的 AI 客户端（Claude Desktop、Claude Code、Codex CLI、Gemini CLI）。
AI 提供商
配置驱动 AI 精灵的 AI 提供商。同一时间只能激活一个提供商。
CLI 提供商 —— 使用本地安装的 AI CLI 工具（Claude、Codex、Gemini）。点击 检测 扫描 $PATH 中可用的 CLI。CLI 提供商使用你的订阅计划，无需 API 密钥。
REST API 提供商 —— 直接连接云端 API（Anthropic、OpenAI、Google AI、Ollama API）。每个都需要端点、API 密钥和模型名称。
各提供商的详细设置说明请参阅 AI 提供商。
格式
非默认格式适配器的可选开关，以及只读代码标签页的外部编辑器命令。
Markdown、纯文本和 YAML/YML 始终已注册 —— 这是默认的稳定选项。其他所有适配器默认关闭，避免升级时出乎意料。切换开关后，注册表即时重建；已打开的标签页会以正确的适配器重新挂载，无需重启。
完整的格式列表及其预览说明，请参阅支持的格式。
格式支持
| 开关 | 默认 | 启用内容 |
|---|---|---|
| 数据格式 | 关闭 | .json、.jsonl、.toml —— 分栏源码 + 可导航树。支持 Cargo.toml、package.json、pyproject.toml 的架构感知预览。 |
| 图表 & SVG | 关闭 | .mmd（Mermaid）和 .svg —— 分栏源码 + 净化后的实时渲染。 |
| HTML 预览 | 关闭 | .html 和 .htm —— 沙盒 iframe 预览（空 sandbox="" 允许列表、DOMPurify、CSP <meta>）。已通过 OWASP top-20 验证 —— 参见 HTML 安全模型。 |
| 代码查看器 | 关闭 | 12 种只读查看器（.ts、.tsx、.js、.jsx、.py、.rs、.go、.css、.sh、.bash、.rb、.lua）。在带语法高亮的查看器中打开，提供 启用编辑 和 在外部编辑器中打开 按钮。 |
当某类别关闭时，匹配的扩展名会回退到纯文本模式，文件仍然可以打开 —— 只是没有架构视图。
外部编辑器
对于只读代码标签页上的 在外部编辑器中打开 按钮，在此选择要启动的编辑器。可以是应用包（例如 /Applications/Visual Studio Code.app）或可执行文件。
图形界面设置优先于任何环境变量 —— 显式优于隐式。留空则使用环境变量回退链 $VMARK_EXTERNAL_EDITOR → $VISUAL → $EDITOR → 平台默认。完整的解析顺序和安全关口说明，请参阅在外部编辑器中打开。
一次性升级提示
首次升级至多格式支持后启动时，VMark 会显示一个无阻塞的提示，引导你前往 设置 → 格式。此提示每次安装只显示一次 —— 显示或关闭后不再出现。
语言
中日韩（中文、日文、韩文）格式化规则。这些规则在你对选中内容运行 格式 → 格式化中日韩选区（Cmd+Shift+F）或对整个文件运行 格式 → 格式化中日韩文档（Alt+Cmd+Shift+F）时应用。
TIP
语言部分包含 20 多个细粒度的格式化开关。每条规则的完整说明和示例请参阅中日韩格式化。
全角标准化
| 设置 | 描述 | 默认值 |
|---|---|---|
| 转换全角字母/数字 | 将全角字母数字字符转换为半角（如 ＡＢＣ 转为 ABC） | 开启 |
| 标准化标点宽度 | 将中日韩字符之间的全角逗号和句号转换为半角 | 开启 |
| 转换括号 | 内容为中日韩时将全角括号转换为半角 | 开启 |
| 转换方括号 | 内容为中日韩时将半角方括号转换为全角 【】 | 关闭 |
间距
| 设置 | 描述 | 默认值 |
|---|---|---|
| 添加中日韩-英文间距 | 在中日韩字符和拉丁字符之间插入空格 | 开启 |
| 添加中日韩-括号间距 | 在中日韩字符和括号之间插入空格 | 开启 |
| 删除货币间距 | 删除货币符号后的多余空格（如 $ 100 变为 $100） | 开启 |
| 删除斜杠间距 | 删除斜杠周围的空格（如 A / B 变为 A/B），保留 URL | 开启 |
| 合并多余空格 | 将多个连续空格减少为单个空格 | 开启 |
破折号与引号
| 设置 | 描述 | 默认值 |
|---|---|---|
| 转换破折号 | 将中日韩字符之间的双连字符（--）转换为破折号（——） | 开启 |
| 修复破折号间距 | 确保破折号周围有适当的间距 | 开启 |
| 转换直引号 | 将直引号 " 和 ' 转换为弯引号 | 开启 |
| 引号样式 | 智能引号转换的目标样式 | 弯引号 "" '' |
| 修复双引号间距 | 规范化双引号周围的间距 | 开启 |
| 修复单引号间距 | 规范化单引号周围的间距 | 开启 |
| 中日韩直角引号 | 将繁体中文和日文文本中的弯引号转换为直角括号 「」，仅在引号样式为"弯引号"时可用 | 关闭 |
| 嵌套直角引号 | 将 「」 内的嵌套单引号转换为 『』 | 关闭 |
清理
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| 限制连续标点 | 限制重复的标点符号如 !!! | 关闭 | 关闭、单个（!! 变为 !）、两个（!!! 变为 !!） |
| 删除行尾空格 | 删除行末的空格 | 开启 | 开启/关闭 |
| 规范化省略号 | 将带空格的点（. . .）转换为正确的省略号（...） | 开启 | 开启/关闭 |
| 合并换行 | 将三个或更多连续换行减少为两个 | 开启 | 开启/关闭 |
快捷键
查看和自定义所有键盘快捷键。快捷键按类别分组（文件、编辑、视图、格式等）。
- 搜索 —— 按名称、类别或按键组合过滤快捷键
- 点击快捷键 更改其绑定，按下新的组合键后确认
- 重置 —— 恢复单个快捷键的默认值，或一次性重置所有快捷键
- 导出/导入 —— 将自定义绑定保存为 JSON 文件，并在另一台机器上导入
完整的默认快捷键参考请参阅键盘快捷键。
终端
配置集成终端面板。使用 Ctrl + ` 打开终端。
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| Shell | 使用哪个 Shell，需要重启终端才能生效 | 系统默认 | 系统上自动检测到的 Shell（如 zsh、bash、fish） |
| 面板位置 | 终端面板放置的位置 | 自动 | 自动（基于窗口纵横比）、底部、右侧 |
| 面板大小 | 终端占用可用空间的比例，拖动调整面板大小也会更新此值 | 40% | 10% 至 80% |
| 字号 | 终端中的文字大小 | 13px | 10px 至 24px |
| 行高 | 终端行间垂直间距 | 1.2（紧凑） | 1.0（紧密）至 2.0（超宽） |
| 光标样式 | 终端光标的形状 | 竖线 | 竖线、方块、下划线 |
| 光标闪烁 | 终端光标是否闪烁 | 开启 | 开启/关闭 |
| 选中即复制 | 自动将选中的终端文本复制到剪贴板 | 关闭 | 开启/关闭 |
| WebGL 渲染器 | 使用 GPU 加速渲染终端，如遇输入法输入问题请禁用，需要重启终端 | 开启 | 开启/关闭 |
有关会话、键盘快捷键和 Shell 环境的更多信息，请参阅集成终端。
关于
显示应用版本、网站和 GitHub 仓库链接，以及更新管理。
更新
| 设置 | 描述 | 默认值 |
|---|---|---|
| 自动更新 | 启动时自动检查更新 | 开启 |
| 立即检查 | 手动触发更新检查 | — |
有可用更新时，会显示一张卡片，显示新版本号、发布日期和版本说明。你可以 下载 更新、跳过 此版本，或 —— 下载完成后 —— 重启以更新。
高级
TIP
高级部分默认隐藏。在设置窗口中按 Ctrl + Option + Cmd + D 可显示。
开发者和系统级配置。
链接协议
| 设置 | 描述 | 默认值 |
|---|---|---|
| 自定义链接协议 | 插入链接时 VMark 应识别的额外 URL 协议，以标签形式输入每个协议 | obsidian、vscode、dict、x-dictionary |
这让你可以创建如 obsidian://open?vault=... 或 vscode://file/... 这样的链接，VMark 会将其视为有效 URL。
性能
| 设置 | 描述 | 默认值 |
|---|---|---|
| 同时保持两个编辑器活跃 | 同时挂载所见即所得和源码模式编辑器，以加快模式切换，会增加内存使用 | 关闭 |
Workflow 引擎
| 设置 | 描述 | 默认值 | 选项 |
|---|---|---|---|
| Workflow 引擎 | 为 .github/workflows/ 下的 .yml / .yaml 文件启用 GitHub Actions workflow 查看器/编辑器。关闭时这些文件以普通 YAML 方式打开 | 关闭 | 开启/关闭 |
| 保留 YAML 格式 | 通过表单面板保存 workflow 编辑时，借助 CST 往返管线保留原 YAML 的注释、锚点、键序和空行。关闭时使用紧凑序列化器（更快但有损） | 开启 | 开启/关闭 |
完整功能介绍请参阅 Workflow 查看器。
平台特定
| 设置 | 描述 | 默认值 | 平台 |
|---|---|---|---|
| 打开时清除 macOS 隔离属性 | 当打开带有 macOS 隔离属性（com.apple.quarantine）的文件时，在读取前剥除该属性。对从网络下载、本来会被 VMark 阻止打开的文件很有帮助 | 开启 | macOS |
| 将 Mac Option 视为 Meta（终端） | 在集成终端中将 macOS Option 键视为 Meta，emacs、tmux 等期待 Alt 前缀快捷键的工具需要此项 | 关闭 | macOS |
开发者工具
当 开发者工具 切换为开启时，会出现一个 热退出开发工具 面板，其中包含用于测试会话捕获、检查、恢复、清除和重启的按钮 —— 在开发过程中调试热退出行为时很有用。