根本不是插件坏了，而是未初始化且依赖「文件已保存」和「项目根目录被识别」；需执行 markdown writer: create default keymaps 初始化快捷键，保存文件并添加项目目录，禁用冲突的 markdown-preview，改用 markdown-preview-plus。
装完 markdown-writer 插件后快捷键没反应、插入图片路径错乱、表格不自动补全——根本不是插件坏了，而是它压根没初始化，且所有功能都依赖「文件已保存」和「项目根目录被识别」这两个状态。
为什么 Ctrl+1 插入标题没反应？必须手动初始化快捷键
插件安装后不会自动注册热键，keymap.cson 里空空如也。Atom 不会提示你缺这步，只默默让快捷键失效。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并执行
Markdown Writer: Create Default Keymaps - 检查
~/.atom/keymap.cson是否生成了类似'atom-text-editor[data-grammar~="source.gfm"]': 'ctrl-1': 'markdown-writer:insert-h1'的规则 - 如果之前手动改过
keymap.cson且有语法错误（比如多逗号、缩进不齐），Atom 会静默跳过全部规则——用 Atom 自带的Config: Validate命令检查
插入图片/链接失败、路径指向 Atom 安装目录？因为文件没保存或没开项目
markdown-writer 所有路径计算（siteLocalDir、imageDirectory、模板生成）都基于当前文件的磁盘路径。未保存的 untitled 文件没有路径，插件只能退化到 Atom 安装目录下瞎猜。
- 确保 Markdown 文件已保存，且后缀为
.md - 必须通过
File → Add Project Folder打开整个项目目录，不能双击单个文件启动 Atom - 项目根目录下放一个
_mdwriter.cson，内容如：{"siteLocalDir": ".", "fileExtension": ".md", "imageDirectory": "assets/"} - 修改配置后必须执行
Window: Reload（或重启 Atom），否则缓存仍用旧值 - Windows 用户写路径时禁用单反斜杠：
"imageDirectory": "assets\"或"assets/"，别写成"assets"（会被当转义符吃掉）
预览窗口卡死、表格不补分隔行、元数据不生效？默认 markdown-preview 在捣鬼
Atom 自带的 markdown-preview 和 markdown-writer 功能重叠但互不兼容。它不支持表格对齐辅助、大纲跳转，更会在你按 ctrl-1 时导致预览窗口卡住或空白。
- 进
Packages → markdown-preview → Settings，把Enable开关设为disabled - 装
markdown-preview-plus或markdown-preview-enhanced替代 - 装完立刻去新插件的 Settings 里启用
Auto-Refresh和Synchronize Preview Scroll - 别装
markdown-scroll-sync——新版markdown-preview-plus（2.4.16+）已自带同步滚动，额外安装反而触发TypeError: Right-hand side of 'instanceof' is not callable
最常被忽略的其实是那个「已保存」和「项目已加载」的状态判断——它不像 VS Code 那样容忍临时文件，也不在界面上给你任何提示。你看到光标不动、图片插到 C:Users…AppData… 下，基本就是这两个条件没满足。
