sublime怎么写markdown_sublime安装markdown插件

7次阅读

sublime text 的 markdown 预览不生效主因是未手动绑定 .md 文件语法类型,需右键设为 markdownediting 的 markdown 语法,并开启 markdown preview 的 autoreload;数学公式需启用 mathjax 及正确配置路径;快捷键冲突需检查 keymap 并添加 context 限定;导出 html 乱码须确保 utf-8 编码与 meta charset 声明。

sublime怎么写markdown_sublime安装markdown插件

sublime text 装完 Markdown 插件后预览不生效

不是插件没装上,而是 Sublime 默认不自动关联 .md 文件到 Markdown 语法高亮和预览功能。装完 MarkdownEditingMarkdown 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 管渲染,两者不互斥但也不自动联动。一个没配好,另一个就卡在半路。最常被忽略的是文件关联和编码一致性 —— 光装插件,不设语法、不查状态栏、不验保存编码,等于没动。

text=ZqhQzanResources