Sublime Text需装MarkdownEditing和MarkdownPreview插件并精确配置才能实现Markdown高亮与预览；必须手动绑定.md文件到Markdown GFM语法、启用mathjax_enabled和toc等扩展、设置parser为github，并确保UTF-8编码及首次手动预览。

Sublime Text 本身不支持 Markdown 实时预览或学术级排版，必须靠插件组合 + 精确配置才能达成；装完 MarkdownPreview 和 MarkdownEditing 后仍无法渲染公式、图表或自动目录，大概率是配置项漏设或作用域未绑定。

怎么让 .md 文件一打开就高亮且支持中文标题缩进

默认的 Packages/Markdown/Markdown.sublime-syntax 语法包太简陋，中文标题前的 # 不着色、列表缩进错位、代码块语言识别失效——这些不是 bug，而是没切换到 MarkdownEditing 提供的完整语法。

• 打开任意 .md 文件，点击右下角当前语法名（如 “Plain Text” 或 “Markdown”）→ 选 Open all with current extension as… → 找到并选择 Markdown GFM（注意不是 “Markdown” 或 “Markdown Extended”）
• 永久绑定：菜单栏 Preferences → Settings – Syntax Specific，右侧用户设置中粘贴：

  {"extensions": ["md", "markdown", "mdown", "mkd"]}

• 若仍无高亮，检查是否启用了兼容性差的主题（如部分 Monokai 变体），临时切到 Adaptive 主题验证

为什么 MathJax 公式不渲染、Mermaid 图表空白

MarkdownPreview 默认关闭高级扩展，数学公式和图表需显式启用，且依赖首次手动预览触发资源加载。

Telegram Markdown Adapter

将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。

下载

• 在 Preferences → Package Settings → Markdown Preview → Settings 中添加：

  {
    "mathjax_enabled": true,
    "markdown_extensions": [
      "extra",
      "codehilite",
      "toc",
      "fenced_code",
      "mdx_math",
      "mermaid2"
    ]
  }

• 公式必须用 $$...$$ 或 \[...\] 包裹（单个 $ 行内公式需额外配 mdx_math）
• Mermaid 图表需写成 ```mermaid 块，且首次预览必须手动执行 Markdown Preview: Preview in Browser，否则浏览器不会加载 mermaid.min.js
• Chrome/Edge 用户需关闭 chrome://settings/privacy 中的 “使用预测服务来加载网页”，否则本地文件刷新会被拦截

如何生成带跳转锚点的 TOC 并支持中文标题

toc 扩展能自动生成目录，但中文标题默认不生成可点击锚点，需配合 html_preview 和编码设置。

• 确保已启用 "toc" 扩展（见上一节配置），并在文档顶部插入 [TOC] 或 [toc]
• 在 MarkdownPreview 设置中必须开启：

  "html_preview": true

• 文件保存编码必须为 UTF-8（右下角状态栏确认显示 “UTF-8”，不是 “UTF-8 with BOM” 或 “Western (Windows 1252)”）
• 中文标题锚点生效前提是：标题行不能含全角空格、制表符或特殊符号（如 【】），推荐只用字母、数字、短横线和中文

Ctrl+Shift+M 没反应？检查 parser 值和快捷键绑定

MarkdownPreview 不自带默认快捷键，Ctrl+Shift+M 是用户自定义的，一旦失效，90% 是 parser 值非法或命令未正确绑定。

• 打开 Preferences → Key Bindings – User，添加如下条目：

  [
    {
      "keys": ["ctrl+shift+m"],
      "command": "markdown_preview",
      "args": {"target": "browser", "parser": "github"}
    }
  ]

• "parser": "github" 是唯一稳定支持中文锚点、任务列表、表格对齐的选项；别写成 "gfm"、"commonmark" 或留空，这些值会导致命令静默失败
• 若仍无效，按 Ctrl+Shift+P 输入 Markdown Preview: Preview in Browser 手动执行一次——成功则说明插件正常，问题纯属快捷键配置；失败则回退检查 Python 路径和 enable_autoreload

最容易被忽略的是：所有配置修改后，必须保存文件再预览，且首次预览必须手动触发；自动刷新只响应保存事件，不响应内容变更（比如边写边改）。公式和 Mermaid 的 JS 资源只在首次预览时下载，断网或路径错误会导致后续始终空白。