markdown-it CLI 是最直接的命令行方案：需先全局安装 npm install -g markdown-it，再在 Markdown 文件目录执行 markdown-it input.md -o output.html；默认无样式，加 --html 参数启用 HTML 标签，删除线、公式等需插件支持，导出 HTML 应用 Live Server 打开以避免 file:// 协议导致的路径错误。
markdown-it CLI 是最直接的命令行方案
VSCode 本身不带 Markdown 导出功能，但只要你装了 Node.js，markdown-it CLI 就能立刻用起来，不用写一行 JS 也能生成 HTML。
- 先全局安装：
npm install -g markdown-it - 在 Markdown 文件所在目录运行：
markdown-it readme.md -o readme.html - 默认输出纯 HTML（无样式），加
--html参数启用 HTML 标签解析（如<br>
、<hr>） - 若要保留代码块高亮，必须额外加插件，比如：
markdown-it --html --plugins markdown-it-prismjs readme.md -o readme.html
注意：markdown-it 默认不支持删除线 ~~text~~、数学公式 $$E=mc^2$$，这些得靠插件补全，否则导出后原样显示或渲染失败。
用 Node 脚本控制渲染行为更灵活
CLI 快，但定制性弱；写个 render.js 脚本能精确控制输出结构、样式注入、目录生成等。
- 项目内安装：
npm install markdown-it markdown-it-anchor markdown-it-toc-and-anchor - 读取文件用
fs.readFileSync('./doc.md', 'utf8')，别漏掉编码参数，否则中文变乱码 - 初始化时开启关键选项：
new markdownit({ html: true, breaks: true, linkify: true })，否则换行、链接不生效 - 插入目录需配合
markdown-it-toc-and-anchor插件，并在文档开头写[TOC]占位符
示例片段：
立即学习“前端免费学习笔记（深入）”；
知识产权官文PDF转markdown
下载
Convert Chinese patent PDFs/DOCX/DOCs to structured Markdown. Supports patent publications (A/B/U) and office action documents (审查意见通知书/驳回决定/复审决定书/无效宣告请求审查决定书). Uses MinerU for high-quality OCR text extraction (falls back to Tesseract), Python scripts for
const md = require('markdown-it')({
html: true,
typographer: true
}).use(require('markdown-it-anchor')).use(require('markdown-it-toc-and-anchor'));
const src = fs.readFileSync('./readme.md', 'utf8');
const html = `<!DOCTYPE html><html><head><meta charset="utf-8"></head><body>${md.render(src)}</body></html>`;
fs.writeFileSync('./readme.html', html);
导出的 HTML 打不开？不是代码问题，是加载方式错了
双击生成的 readme.html 打不开、图片 404、样式丢失——几乎全是 file:// 协议惹的祸，不是你路径写错，也不是插件没生效。
- 浏览器用
file://加载时，无法读取相对路径的 CSS/JS/图片，会报net::ERR_FILE_NOT_FOUND - 正确做法：装 VSCode 插件
Live Server，右键该 HTML 文件 →Open with Live Server，自动起http://127.0.0.1:5500 - 如果只是看源码结构，不用运行效果，直接在 VSCode 里按
Ctrl+P输入readme.html回车即可打开编辑
别花时间改 <link href="./style.css"> 为绝对路径——治标不治本，换环境又崩。
插件方案省事但容易踩坑
像 Markdown Preview Enhanced 或 Preview to HTML 这类插件，点一下就出 HTML，但实际交付时问题集中暴露。
-
Preview to HTML导出的是单文件（所有 CSS/JS 内联），体积大、难调试，且 Mermaid 图表大概率空白 -
Markdown Preview Enhanced支持导出带 TOC 的 HTML，但默认不启用 MathJax，公式$$...$$会原样输出 - 所有插件默认把 HTML 写到和源文件同目录，文件名硬编码为
xxx_preview.html，不能自定义输出名或子目录 - 它们不读你 VSCode 主题色，Dark+ 预览导出仍是白底黑字
如果你需要稳定复现、批量处理、或嵌入 CI 流水线，脚本或 CLI 方案才是唯一可靠路径。
