sublime text 的 markdown 预览不生效主因是未手动绑定 .md 文件语法类型，需右键设为 markdownediting 的 markdown 语法，并开启 markdown preview 的 autoreload；数学公式需启用 mathjax 及正确配置路径；快捷键冲突需检查 keymap 并添加 context 限定；导出 html 乱码须确保 utf-8 编码与 meta charset 声明。
Sublime Text 装完 Markdown 插件后预览不生效
不是插件没装上，而是 Sublime 默认不自动关联 .md 文件到 Markdown 语法高亮和预览功能。装完 MarkdownEditing 或 Markdown Preview 后，得手动设置文件类型绑定。
- 右键编辑区 → “Set Syntax” → “Open all with current extension as…” → “Markdown”（注意选的是 MarkdownEditing 提供的 Markdown，不是自带的 Plain Text）
- 如果用
Markdown Preview，还需确认Preferences → Package Settings → Markdown Preview → Settings中"enable_autoreload": true已开启，否则保存后浏览器不会自动刷新 - 常见错误：装了插件但右键菜单里没有
Markdown Preview: Preview in Browser—— 这通常是因为快捷键或命令未加载成功，重启 Sublime 或执行Ctrl+Shift+P输入Package Control: Satisfy Dependencies补全依赖
用 Markdown Preview 渲染数学公式（LaTeX）失败
Markdown Preview 默认不支持 $...$ 或 $$...$$ 数学块，需额外配置 MathJax 渲染器，且本地网络或路径不对就直接白屏。
- 打开
Preferences → Package Settings → Markdown Preview → Settings - 把
"mathjax": true设为true，并确保"js": ["mathjax"]在"markdown_extensions"列表中 - 如果公司内网禁外链，MathJax CDN 加载失败 → 改用本地 MathJax：下载 MathJax 到本地（如
~/mathjax/），在设置中指定"mathjax_path": "/Users/xxx/mathjax/MathJax.js" - 注意：
$$块级公式在某些扩展组合下会被误解析成删除线，可改用\[ ... \]替代
Sublime 的 Markdown 快捷键冲突或不响应
比如按 Ctrl+B 想加粗却弹出构建面板，或 Ctrl+Shift+P 打不开命令面板 —— 多数是插件间快捷键覆盖，或 MarkdownEditing 未设为默认语法模式。
- 检查当前文件右下角状态栏是否显示
Markdown（而不是Plain text），没显示就说明语法未绑定 - 快捷键冲突排查：打开
Preferences → Key Bindings，搜索ctrl+b，看是否被其他插件（如 SideBarEnhancements）劫持；可在用户 keymap 里加一条覆盖：[{"keys": ["ctrl+b"], "command": "markdown_editing.bold", "context": [{"key": "selector", "operator": "equal", "operand": "text.html.markdown"}]}] - 部分快捷键（如标题生成
Ctrl+1）只在光标位于行首时生效，缩进后失效是正常行为，不是 bug
导出 HTML 时样式丢失或中文乱码
直接用 Markdown Preview → Save to HTML 导出，常出现字体发虚、代码块无高亮、中文标点间距炸开 —— 根源在 CSS 注入方式和编码声明缺失。
- 导出前务必确认
"html_preview": true和"enable_highlight": true都已启用，否则代码块只是纯文本 - 中文乱码多因 HTML 模板缺
<meta charset="utf-8">，可在Markdown Preview → Settings中修改"css":字段，追加自定义 CSS 文件，并确保该 CSS 文件本身用 UTF-8 编码保存 - 若用 GitHub 风格渲染（
"github_mode": true），会跳过本地 CSS，样式更简陋但兼容性高；想保留自定义样式，就得关掉它
插件之间依赖关系松散，MarkdownEditing 管语法高亮，Markdown Preview 管渲染，两者不互斥但也不自动联动。一个没配好，另一个就卡在半路。最常被忽略的是文件关联和编码一致性 —— 光装插件，不设语法、不查状态栏、不验保存编码，等于没动。
