sublime text 默认不渲染 markdown 文件,需安装官方推荐插件 markdownpreview(非 markdown preview 或 markdownediting);安装后需配置浏览器路径、确保文件已保存且编码为 utf-8,启用自动刷新后保存即可实时预览。

Sublime Text 里打开 .md 文件默认不渲染?
不是 Sublime 本身的问题,是它压根不带 Markdown 渲染功能——Sublime Text 是纯文本编辑器,不是预览器。所谓“实时预览”,得靠插件补上这一块。
常见错误现象:Ctrl+Shift+P 调出命令面板输 Markdown Preview 却找不到;或者装了插件但按 Ctrl+Shift+P → Markdown Preview: Preview in Browser 没反应;又或者预览打开空白页、报 404 或 Failed to load resource。
关键原因:插件没装对、没启用、或路径/配置冲突。
装哪个插件?别选错名字
官方推荐且维护活跃的是 MarkdownPreview(注意没有空格,首字母大写),不是 Markdown Preview(旧版已弃用)、也不是 MarkdownEditing(只管语法高亮和快捷键)。
安装方式(必须用 Package Control):
- 确保已装
Package Control(没装就先搜 “Install Package Control Sublime Text”) -
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车 - 等加载完,输入
MarkdownPreview→ 选中回车安装
装完不用重启,但得确认插件已启用:Preferences → Package Settings → MarkdownPreview 如果菜单存在,说明成功。
预览打不开 / 打开空白?检查这几个点
最常卡在这几个地方,顺序排查比重装快得多:
-
MarkdownPreview的默认浏览器设置是否为空?在Preferences → Package Settings → MarkdownPreview → Settings里看"browser"字段,如果是null或空字符串,改成"chrome"或"firefox"(大小写敏感,Windows 下也可用"msedge") - 当前文件没保存?
MarkdownPreview默认只处理已保存的.md文件,临时 tab(untitled)不会预览 - 文件编码不是 UTF-8?右下角状态栏点编码名,选
UTF-8,否则中文可能乱码甚至中断解析 - 用了自定义 CSS 但路径错了?如果改过
"css": ["path/to/style.css"],确保路径是相对于 Sublime 安装目录或项目根目录的绝对/相对路径,建议先注释掉这行测试
想边写边看?别依赖“自动刷新”
MarkdownPreview 没有真正的实时双栏预览(像 Typora 那样)。它的“实时”是指:每次手动触发(Ctrl+Shift+P → Markdown Preview: Preview in Browser)后,后续编辑只要保存(Ctrl+S),浏览器页会自动刷新——前提是浏览器页没关、且插件设置里 "enable_autoreload" 是 true(默认开启)。
容易被忽略的细节:
- 第一次预览必须手动触发一次,之后保存才自动刷新
- 如果浏览器用了隐私模式或禁用了 JS,自动刷新会失效
- Mac 上 Safari 对本地
file://协议限制更严,推荐用 Chrome 或 Firefox - 想看数学公式?得额外配
"mathjax": true并联网,离线环境不生效
真要高频预览,不如把浏览器窗口拖到副屏,保存即见变化——这是目前 Sublime 下最稳的节奏。










