markdown preview插件默认仅预览不生成html文件，需手动执行“save to html”且原文件必须已保存；导出带样式、目录和代码高亮需在设置中启用github_css、enable_highlight和build_toc；本地打开需注意路径安全与浏览器限制。
Markdown Preview 插件装完为啥不生成 HTML 文件？
它只预览，不导出——这是最常卡住的地方。Markdown Preview 默认行为是实时渲染到新标签页，不是生成 .html 文件。想发布文档，得手动触发「保存为 HTML」动作，而且必须先保存当前 .md 文件（未保存的临时文件无法导出）。
实操建议：
- 确保文件已保存，路径不含中文或空格（比如
C:/docs/readme.md安全，我的笔记.md可能失败） - 右键编辑区 → 选
Markdown Preview: Save to HTML（不是“Open Preview”） - 生成的 HTML 默认和原文件同目录，后缀是
.md.html，比如readme.md.html - 如果菜单里没这个选项，说明插件没正确加载：按
Ctrl+Shift+P输入Package Control: Install Package，重装一遍Markdown Preview
怎么让导出的 HTML 带样式、目录、代码高亮？
默认导出是裸 HTML，没 CSS、没 TOC、```python 块就是纯文本。要这些功能，得改插件配置，核心是启用 github_css、enable_highlight 和 build_toc 这三个开关。
实操建议：
- 菜单栏 →
Preferences → Package Settings → Markdown Preview → Settings – User - 在右边 JSON 里加这几项（注意逗号）：
{
"enabled_extensions": ["fenced_code", "tables", "def_list", "footnotes"],
"github_css": true,
"enable_highlight": true,
"build_toc": true
}
改完保存，再执行 Save to HTML 就会带 GitHub 风格样式、左侧目录栏、以及基础语法高亮（支持 Python/JS/JSON 等常见语言）。
导出的 HTML 打不开本地图片或链接跳转错乱？
因为默认导出是「相对路径引用」，但浏览器直接双击打开 file:// 协议时，CSS/图片/锚点可能被安全策略拦截或解析失败。这不是插件 bug，是浏览器对本地文件的限制。
实操建议：
- 图片务必用相对路径，且和 HTML 同级或子目录，比如
，不要用../assets/跨父目录 - 避免用
[点击这里](#section1)这类纯 ID 锚点，改成完整路径[点击这里](readme.md.html#section1)（导出后 ID 会保留） - 真要本地双击查看，推荐用
Python -m http.server 8000起个临时服务器，然后访问http://localhost:8000/readme.md.html - 如果必须发给他人离线使用，把生成的
.html+markdown_preview.css（插件目录下可找到）+ 图片文件夹一起打包
Sublime 自带的 Markdown 语法高亮不匹配导出效果？
Sublime 内置的 Markdown 语法定义（Packages/Markdown/Markdown.sublime-syntax）和 Markdown Preview 渲染引擎（基于 Python-Markdown）对某些扩展语法的支持不一致。比如 ~~删除线~~ 在编辑器里不标红，但导出 HTML 里能显示；而某些表格写法可能编辑器高亮错，导出却正常。
实操建议：
- 别依赖编辑器实时高亮来判断最终 HTML 效果，以
Save to HTML结果为准 - 如果发现某语法始终导出异常（比如数学公式
$E=mc^2$），确认是否启用了math扩展："enabled_extensions": ["fenced_code", "tables", "math"] - 复杂文档建议导出后用浏览器开发者工具检查元素，看是 CSS 没加载，还是 HTML 结构本身没生成出来
导出逻辑其实就两步：解析 Markdown → 套模板生成 HTML。中间任何一环路径不对、扩展没开、文件未保存，都会静默失败。盯住控制台（View → Show Console）里有没有 ERROR 或 Permission denied 提示，比反复试更省时间。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
