导出与打印

VMark 提供多种方式导出和分享你的文档。

导出模式

文件夹模式（默认）

创建具有清晰结构的自包含文件夹：

MyDocument/
├── index.html
└── assets/
    ├── image1.png
    ├── image2.jpg
    └── ...

优点：

服务时 URL 简洁（/MyDocument/ 而不是 /MyDocument.html）
作为单个文件夹分享方便
资源路径简单（assets/image.png）
非常适合静态网站托管

单文件模式

创建单个自包含 HTML 文件：

MyDocument.html

所有图片均以 data URI 形式嵌入，使其完全可移植，但文件体积较大。

如何导出

导出 HTML

使用 文件 → 导出 HTML
选择导出位置
文件夹模式：输入文件夹名称（如 MyDocument）
单文件模式：输入带 .html 扩展名的文件名

打印 / 导出 PDF

按 Cmd/Ctrl + P 或使用 文件 → 打印
使用系统打印对话框打印或另存为 PDF

导出为其他格式

VMark 集成了 Pandoc —— 一款通用文档转换工具 —— 可将 Markdown 导出为其他格式。直接从菜单选择格式：

文件 → 导出 → 其他格式 →

菜单项	扩展名
Word (.docx)	`.docx`
EPUB (.epub)	`.epub`
LaTeX (.tex)	`.tex`
OpenDocument (.odt)	`.odt`
Rich Text (.rtf)	`.rtf`
Plain Text (.txt)	`.txt`

安装步骤：

从 pandoc.org/installing 安装 Pandoc，或通过包管理器安装：
- macOS：brew install pandoc
- Windows：winget install pandoc
- Linux：apt install pandoc
重启 VMark（或进入 设置 → 文件与图片 → 文档工具 并点击检测）
使用 文件 → 导出 → 其他格式 → [格式] 进行导出

如果未安装 Pandoc，菜单会在"其他格式"子菜单底部显示一个 "需要 Pandoc — pandoc.org" 链接。

你可以在 设置 → 文件与图片 → 文档工具 中确认 Pandoc 是否已被检测到。

复制为 HTML

按 Cmd/Ctrl + Shift + C 将渲染后的 HTML 复制到剪贴板，以便粘贴到其他应用程序。

VMark 阅读器

当你导出为 HTML 时，你的文档包含 VMark 阅读器 —— 一种具有强大功能的交互式阅读体验。

设置面板

点击齿轮图标（右下角）或按 Esc 打开设置面板：

设置	描述
字体大小	调整文本大小（12px – 24px）
行高	调整行间距（1.2 – 2.0）
主题	切换主题（White、Paper、Mint、Sepia、Night）
中日韩-拉丁间距	切换中日韩和拉丁字符之间的间距

阅读进度

页面顶部有一个细微的进度条，显示你已读了多少文档。

回到顶部

向下滚动时会出现一个浮动按钮。点击它或按 Home 返回顶部。

图片灯箱

点击任意图片以全屏灯箱查看：

关闭：点击外部、按 Esc 或点击 X 按钮
导航：使用 ←/→ 方向键浏览多张图片
缩放：图片以其自然大小显示

代码块

每个代码块包含交互控件：

按钮	功能
行号切换	显示/隐藏该块的行号
复制按钮	将代码复制到剪贴板

复制成功时显示复选标记。

脚注导航

脚注完全交互式：

点击脚注引用 [1] 跳转到其定义
点击 ↩ 反向链接返回原来阅读的位置

键盘快捷键

按键	操作
`Esc`	切换设置面板
`T`	切换目录
`↑` / `↓`	导航目录项
`Enter`	跳转到选中的目录项
`←` / `→`	在灯箱中导航图片
`Home`	滚动到顶部

导出快捷键

操作	快捷键
导出 HTML	（仅菜单）
打印	`Mod + P`
复制为 HTML	`Mod + Shift + C`

技巧

托管导出的 HTML

文件夹导出结构非常适合任何静态文件服务器：

bash

# Python
cd MyDocument && python -m http.server 8000

# Node.js (npx)
npx serve MyDocument

# 直接打开
open MyDocument/index.html

离线查看

两种导出模式均可完全离线使用：

文件夹模式：在任意浏览器中打开 index.html
单文件模式：直接打开 .html 文件

数学公式（KaTeX）需要联网加载样式表，但其他所有内容均可离线使用。

最佳实践

使用文件夹模式 用于你要分享或托管的文档
使用单文件模式 用于通过电子邮件或聊天快速分享
为图片添加描述性替代文本 以提升可访问性
在不同浏览器中测试导出的 HTML

导出与打印 ​

导出模式 ​

文件夹模式（默认） ​

单文件模式 ​

如何导出 ​

导出 HTML ​

打印 / 导出 PDF ​

导出为其他格式 ​

复制为 HTML ​

VMark 阅读器 ​

设置面板 ​

目录 ​

阅读进度 ​

回到顶部 ​

图片灯箱 ​

代码块 ​

脚注导航 ​

键盘快捷键 ​

导出快捷键 ​

技巧 ​

托管导出的 HTML ​

离线查看 ​

最佳实践 ​