Sublime编写Markdown文档指南_实时预览与学术论文排版高效技巧-sublime-PHP中文网

sublime text需装markdownediting和markdownpreview插件并精确配置才能实现markdown高亮与预览；必须手动绑定.md文件到markdown gfm语法、启用mathjax_enabled和toc等扩展、设置parser为github，并确保utf-8编码及首次手动预览。

sublime编写markdown文档指南_实时预览与学术论文排版高效技巧

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

Web fetch markdown of page

通过 jina.ai 将网页抓取为精简的 markdown，用于在需要获取 URL 并获取压缩的 markdown 内容以节省 token。触发词 l...

下载

在 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