Sublime怎么编写Markdown Sublime怎么实时预览MD文档【写作】

sublime Text 里写 markdown，别装插件就开写

sublime text 本身不带 Markdown 语法高亮和渲染，但开箱即用就能识别 .md 后缀——只要文件名以 .md 或 .markdown 结尾，右下角会自动显示 “Markdown” 语言模式，触发基础语法着色。不需要装任何插件也能写，只是纯文本编辑器级别的支持。

常见错误现象：Sublime Text 打开 readme.md 却显示为纯文本（黑底白字无颜色）——大概率是右下角语言模式被手动切成了 Plain text，点一下右下角文字，选回 Markdown 就行。

• 语言模式切换路径：右下角点击 → 搜索 Markdown → 选中即可
• 想默认打开所有 .md 文件都用 Markdown 模式？在菜单栏 View → Syntax → Open all with current extension as… → Markdown
• 注意：仅设置语法高亮，不等于能预览；高亮靠 Sublime 自身，预览必须依赖插件或外部工具

实时预览 Markdown 必须用插件，但别乱装 Package Control

Sublime Text 原生不支持 HTML 渲染面板，所谓“实时预览”，本质是调用插件启动一个本地服务，把当前 MD 转成 HTML 并用浏览器打开或内嵌 iframe。最稳定、维护活跃的是 MarkdownPreview，不是 MarkdownEditing（它只管编辑体验）。

容易踩的坑：Package Control 安装完插件后没重启 Sublime，或者装了多个预览插件互相冲突（比如同时装了 MarkdownPreview 和 OmniMarkupPreviewer），结果快捷键失效、右键菜单消失、甚至保存时卡住。

• 只装一个预览插件：推荐 MarkdownPreview，github 主页明确标注支持 Sublime Text 4，兼容性好
• 安装后必须重启 Sublime，否则 ctrl+shift+P 里搜不到 Markdown Preview: Preview in Browser
• 默认预览用系统默认浏览器；想换 chrome 或 edge，改配置项 "browser": "chrome"，路径不用填，插件已内置常见浏览器识别逻辑
• 预览不是“所见即所得”：表格对齐、自定义 CSS、部分 HTML 标签（如 <details></details>）可能不渲染，这是预期行为，不是 bug

快捷键和右键菜单失效？检查插件绑定和作用域

装完 MarkdownPreview，按 ctrl+shift+P 能搜到命令但快捷键 ctrl+shift+M 不响应，或者右键没 “Preview in Browser” 选项——问题通常出在作用域（scope）没匹配上，也就是 Sublime 没认定当前文件是 Markdown。

验证方式：按 ctrl+shift+P 输入 Set Syntax: Markdown 手动设一次，再试快捷键。如果好了，说明之前语言模式没生效；如果还是不行，看配置是否覆盖了快捷键。

• 检查快捷键是否被其他插件占用：打开 Preferences → Key Bindings，左侧是默认键位，右侧是用户键位，确认 ctrl+shift+M 没被重写成别的命令
• 确保当前视图作用域是 text.html.markdown：按 ctrl+alt+shift+P 看状态栏，应显示该 scope；若显示 text.plain，说明文件没被识别为 Markdown
• 插件配置里有 "enable_autoreload": true 是开启保存即刷新，但只对浏览器预览有效；内嵌预览（Preview in Sidebar）不支持自动刷新，需手动再按一次快捷键

性能差、卡顿、预览空白？关掉实时监听和多余渲染器

大文件（>10KB）或含大量图片/脚本的 Markdown 在预览时容易卡顿、浏览器打不开、甚至 Sublime 整体变慢——根本原因是 MarkdownPreview 默认启用了 autoreload 和多渲染器（GitHub、MultiMarkdown、Python-Markdown）并行解析。

真实场景中，95% 的文档用 Python-Markdown 渲染器就够了，其余两个反而增加启动延迟和内存占用。

• 关闭自动重载：配置项设 "enable_autoreload": false，手动按快捷键更稳
• 指定单一渲染器：加配置 "parser": "pythonmarkdown"，避免插件每次猜用哪个
• 禁用 MathJax（除非真写公式）：配置里删掉或注释掉 "enable_mathjax"，能明显提速
• 图片路径别用绝对路径：预览时相对路径（如 ![](assets/logo.png)）才可正常加载；file:/// 开头的绝对路径在浏览器沙箱下会被拦截

真正麻烦的从来不是装插件，而是插件之间 scope 没对上、配置项互相覆盖、还有那些藏在 Preferences → Package Settings → MarkdownPreview → Settings 里的默认值——它们不会主动告诉你正在生效。