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),否则导出后格式会丢。 <h3>插件方案:Preview to HTML 比较省事但有坑</h3> <p>VSCode 插件市场搜 <code>Preview to HTML</code></p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9749" title="OCR 文档识别转 Markdown(WiseOCR)"><img src="https://img.php.cn/upload/skill/001/246/273/6adaf20e695c2374.jpg" alt="OCR 文档识别转 Markdown(WiseOCR)" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill9749" title="OCR 文档识别转 Markdown(WiseOCR)" class="overflowclass">OCR 文档识别转 Markdown(WiseOCR)</a> <p class="overflowclass">WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本,支持表格完整识别、多栏版式还原、中英文混排。适用场景:扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式:PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发:用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi</p> </div> <a rel="nofollow" href="/xiazai/skill9749" title="OCR 文档识别转 Markdown(WiseOCR)" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>(作者 yuichinukiyama),安装后右键预览页 → “Save Preview to HTML”。但它有几个实际限制:
- 导出结果是内联样式 + 内联脚本的单 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 就容易露馅。










