ctrl+shift+m没反应是因为四个硬性条件未满足：文件必须已保存且后缀为.md或.markdown；右下角状态栏须显示markdown；路径不能含空格或中文；必须禁用原生markdown-preview插件。
Ctrl+Shift+M没反应？先看这四个硬性条件
不是快捷键坏了，是 Atom 拒绝触发预览——它对环境非常挑剔，不满足就静默失败。
- 文件必须已保存，且后缀为
.md或.markdown（.MD、.txt、.mmd都不行） - 右下角状态栏必须显示 Markdown —— 若显示
Plain Text，点击它手动切换 - 路径不能含空格或中文（例如
/Users/张三/note.md会失败；建议暂存到/tmp/test.md测试） -
markdown-preview原生插件必须禁用：Settings → Packages →markdown-preview→ 点齿轮图标 →Disable
MathJax 公式渲染失效的常见原因
学术写作离不开公式，但 $$E=mc^2$$ 渲染成纯文本，通常不是 MathJax 没装，而是链路断在中间。
Xlsx To Markdown
下载
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
-
markdown-preview-plus设置里必须勾选Enable MathJax（Settings → Packages →markdown-preview-plus→ Settings） - 公式块需严格符合 LaTeX 语法：双美元符
$$...$$或\begin{equation}...\end{equation}，$...$行内公式默认不启用，需额外配置 - 光标不在公式块内时，
Ctrl+Shift+X不会触发局部渲染；该快捷键只作用于当前光标所在公式块 - 若页面加载后公式仍为乱码，打开 DevTools（
Ctrl+Shift+I），看 Console 是否报MathJax is not defined—— 多因网络策略拦截了 CDN 资源，可尝试离线 MathJax 或换用 KaTeX 渲染器（需改插件源码，不推荐新手）
同步滚动为什么卡在顶部不动
编辑第 200 行，预览却停在开头，不是插件坏了，而是同步机制被绕过了。
-
markdown-scroll-sync插件不用单独装：新版markdown-preview-plus（≥2.4.16）已内置该功能，只需在它的 Settings 中开启Synchronize Preview Scroll - 单独装
markdown-scroll-sync反而容易冲突，官方明确提示“不要额外安装” - 同步依赖段落锚点生成，若 Markdown 结构异常（如 YAML front matter 后紧跟标题未空行、列表缩进错位），会导致锚点丢失，滚动即失效
- 预览窗口被手动拖动过位置后，有时会脱离同步状态；关闭再重开
Ctrl+Shift+M即可重置
导出 PDF 时格式错乱或空白
Atom 本身不支持原生导出，所有“导出”都走第三方路径，稳定性差——别指望插件一键搞定。
-
markdown-preview-plus:export-html命令常报Cannot read property 'getEditor' of undefined：大概率是没重启 Atom，或光标没落在 Markdown 编辑器标签页内 - 路径含中文或空格时，部分版本会静默失败；导出前先切到英文路径，例如
/tmp/export.html - 真正稳定的做法是命令行组合：
marked -o /tmp/temp.html input.md && chrome --headless --disable-gpu --print-to-pdf=output.pdf /tmp/temp.html
加--print-to-pdf-no-header可去页眉页脚 - 样式控制靠 Markdown 文件头部的
<style></style>块，例如<style>body{font-family:"Times New Roman",serif; line-height:1.6;}</style>，marked会原样保留
