VSCode 自带预览不能导出 HTML；其内置 Markdown 预览（Ctrl+Shift+V 或右键“Open Preview”）仅支持只读渲染，无导出功能，菜单中不存在“导出为 HTML”选项；如需导出，须借助插件或命令行工具如 markdown-it CLI。

VSCode 自带预览不能导出 HTML？

VSCode 内置的 Markdown 预览（Ctrl+Shift+V 或右键 → “Open Preview”）只是只读渲染，不提供导出功能。你点右键、菜单、设置里都找不到“导出为 HTML”选项——这不是你漏看了，它确实没有。

用 markdown-it CLI 手动转成 HTML 最稳

依赖少、可控性强，适合需要保留样式或批量处理的场景。前提是本地装了 Node.js：

• 运行 npm install -g markdown-it（全局安装）
• 在 Markdown 文件所在目录执行：markdown-it input.md -o output.html
• 默认不带 CSS，如需基础样式，加 --html 参数（启用 HTML 输出）并配合自定义 CSS 文件，例如：markdown-it --html --css ./style.css input.md -o output.html

注意：markdown-it 默认不解析 ~~strikethrough~~ 或 $$math$$，得额外加插件（如 markdown-it-sub、

markdown-it-mathjax</code），否则导出后格式会丢。</p>

<H3>插件方案：Preview to HTML 比较省事但有坑</H3>
<p>VSCode 插件市场搜 <code>Preview to HTML

（作者 yuichinukiyama），安装后右键预览页 → “Save Preview to HTML”。但它有几个实际限制：

Telegram Markdown Adapter

将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。

下载

• 导出结果是内联样式 + 内联脚本的单 HTML 文件，体积大、难维护
• 对 Mermaid 图表支持不稳定，有时导出为空白或报错 Cannot read property 'getDiagram' of undefined
• 不继承你当前主题配色（比如你在 VSCode 用 Dark+，导出仍是浅色背景）
• 无法控制输出路径，默认保存到源文件同目录，且文件名硬编码为 xxx_preview.html

导出 PDF？别用打印另存为

很多人试过浏览器里打开预览页 → Ctrl+P → “Save as PDF”，结果发现代码块断行错乱、表格跑版、Mermaid 图消失。根本原因是 VSCode 预览页用的是简易渲染器，CSS 媒体查询和打印样式没适配。

真要 PDF，推荐走两步：

• 先用上面提到的 markdown-it 导出为 HTML（确保含完整样式）
• 再用 wkhtmltopdf 命令行工具转：wkhtmltopdf --zoom 1.2 --enable-local-file-access input.html output.pdf

--enable-local-file-access 很关键，否则引用的本地 CSS/JS 会 403；--zoom 1.2 是为了缓解代码块换行过紧的问题。

导出这件事，核心不是“能不能点一下就完事”，而是“你对输出质量、样式一致性、后续可维护性的容忍度在哪”。自动化的插件省时间，但一遇到数学公式、流程图、自定义 class 就容易露馅。