Sublime怎么写Markdown_Sublime Markdown编辑教程【写作】

2次阅读

sublime text 需配置语法识别、安装 markdownpreview 插件、设置自动刷新与 utf-8 编码、启用 pygments 高亮,才能正确识别 .md 文件、高效编辑、实时预览并导出带样式的 html。

Sublime怎么写Markdown_Sublime Markdown编辑教程【写作】

sublime text 本身不内置 Markdown 渲染,但能高效写 Markdown——关键在装对插件、配好快捷键、避开预览陷阱。

怎么让 Sublime 正确识别 .md 文件

默认打开 .md 文件时,Sublime 可能用纯文本模式,没有语法高亮,也没有自动补全。这不是 bug,是没指定语法类型。

  • 手动切换:右下角点击当前语法名(比如 “Plain Text”),选 MarkdownMarkdown Extended
  • 自动绑定:进 Preferences → Settings – Syntax Specific,粘贴:
    {"extensions": ["md", "markdown"], "syntax": "Packages/Markdown/Markdown.sublime-syntax"}
  • 别用 MarkdownEditing 插件的旧版语法路径(如 Packages/MarkdownEditing/Markdown.tmLanguage),Sublime 4+ 已弃用 .tmLanguage,会失效或报错

常用 Markdown 操作怎么快速输入

手敲 ### 标题[链接](url) 太慢,Sublime 的 snippet 和快捷键才是效率核心。

  • 内置 snippet:输入 h1 + Tab# link + Tab[text](url)
  • 推荐装 MarkdownPreview 插件后,它自带更多 snippet(如 imglist
  • 别依赖鼠标点菜单插入链接——容易漏空格或括号错位;用 Ctrl+Shift+P 调出命令面板,输 Markdown: Insert Link 更稳

实时预览为什么打不开或不刷新

MarkdownPreview 是最常用的预览插件,但它默认不自动刷新,且容易因路径或浏览器配置失败。

  • 预览前先保存文件:Ctrl+S,否则预览的是未保存内容(尤其粘贴大段文本后)
  • 首次预览失败?检查 Preferences → Package Settings → Markdown Preview → Settings"browser": "chrome" 是否匹配你实际安装的浏览器名(macos"chrome"windows 常要写 "chrome.exe"
  • 改完 Markdown 不刷新?默认只支持保存后刷新;想实时响应,加配置:
    "enable_autoreload": true

    ,但注意这会轻微增加 CPU 占用

  • 别用系统自带的“预览”按钮(右上角小图标),它调用的是旧版 sublime-markdown-popups,不支持表格、脚注等新语法

导出 HTML 总是缺样式或乱码

直接用 MarkdownPreview: Save to HTML 导出,常遇到 CSS 不加载、中文变问号、代码块无高亮。

  • 导出前确认设置了主题:mdpopups 主题或 github 主题更接近 GitHub 效果,配置项是 "markdown_extensions" 里的 "mdpopups"
  • 中文乱码?在导出设置里加:
    "encoding": "utf-8"

    ,并确保源文件本身是 UTF-8 编码(右下角看,不是 ANSI)

  • 代码块没高亮?MarkdownPreview 默认不启用 Pygments;需开启:
    "enable_highlight": true

    ,并确保系统已装 Python 和 pygmentspip install pygments

真正卡住人的往往不是不会装插件,而是导出 HTML 后发现样式丢了,或者改了一行标题,预览却还停在三分钟前——这些细节没对齐,整个流程就断在最后一步。

text=ZqhQzanResources