MarkdownViewerPro

MarkdownViewerPro 是一个专注于 Markdown 文档预览与导出的 VS Code 扩展。它提供主题切换、正文缩放、大纲导航、全文查找、自动刷新，以及 PDF、HTML 和 PNG 长图导出。

功能

预览是只读的。需要修改文档时，可切换回 VS Code 原生文本编辑器。

内置 18 套预览主题，选择后会在所有 Markdown 文档中保持：

暗色：Catppuccin Mocha、Catppuccin Macchiato、Catppuccin Frappe、Dracula、Nord、One Dark、Tokyo Night、Gruvbox Dark、Solarized Dark、Rose Pine
亮色：GitHub Light、Catppuccin Latte、Solarized Light、Gruvbox Light、One Light、Rose Pine Dawn、Ayu Light、Tokyo Night Light

默认主题为 Catppuccin Mocha。

扩展会读取文档中的 h1–h6 标题并生成分层大纲：

没有标题的文档不会显示大纲控件。

在预览中按 Ctrl/Command + F 打开查找栏：

单次查找最多处理 5000 个匹配项，超过上限时计数后会显示 +。

扩展会精确监听当前 Markdown 文件，并在文件内容变化后重新渲染：

预览右下角的导出菜单会按照当前预览主题生成文件。导出结果保存在 Markdown 文件所在目录，并使用相同的文件名：

格式	输出规则	是否需要 Chromium
HTML	内联预览样式，保留相对资源路径	否
PDF	优先生成与正文等高的单页 PDF，超出 Chromium 尺寸限制时自动改为分页	是
PNG	以 2 倍像素密度生成整页长图，尺寸过大时自动降为 1 倍重试	是

例如，导出 notes.md 会在同一目录生成 notes.html、notes.pdf 或 notes.png。如果目标文件已经存在，将直接覆盖。

超长文档即使降为 1 倍像素密度仍无法生成 PNG 时，扩展会提示改用 PDF。

编辑器标题栏中的导出命令还提供 PDF、HTML 和 DOCX 三种传统导出方式。其中 PDF 和 DOCX 需要 Chromium，HTML 不需要。

扩展按以下顺序选择导出浏览器：

扩展启动后会在后台预下载导出引擎。简体中文环境优先使用国内镜像，下载失败时会尝试官方源，最后回退到系统浏览器。

在 VS Code 设置中搜索 vscode-office：

设置项	作用
`vscode-office.workspacePathAsImageBasePath`	使用工作区目录而不是 Markdown 文件目录解析相对图片路径
`vscode-office.chromiumPath`	指定 PDF、PNG 和 DOCX 导出使用的浏览器可执行文件
`vscode-office.puppeteerArgs`	向导出浏览器传递额外启动参数
`vscode-office.pdfMarginTop`	设置传统 PDF 导出的顶部边距
`vscode-office.pasterImgPath`	设置在 Markdown 编辑器中粘贴图片时的保存路径模板
`vscode-office.enableTelemetry`	启用或关闭匿名使用数据收集

遥测遵循 VS Code 的全局遥测设置，详细说明见 docs/telemetry.md。

需要 Node.js 20.19 或更高版本。

npm install
npm run build
npx @vscode/vsce package --no-dependencies

打包完成后，项目根目录会生成 MarkdownViewerPro-<version>.vsix。

本项目使用 MIT License。