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]占位符
示例片段:
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 = `<meta charset="utf-8">${md.render(src)}`;
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 方案才是唯一可靠路径。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











