Atom中markdown-writer插件无响应，主因是快捷键未初始化、配置未加载或文件未保存致路径识别失败；需手动执行“Markdown Writer: Create Default Keymaps”命令、确保文件已保存并以项目方式打开、检查keymap.cson语法及_mdwriter.cson配置正确性。
Atom 里装了 markdown-writer 却没反应？大概率是快捷键没生效、配置没加载，或者文件没保存导致路径识别失败。
安装完插件后为什么快捷键不工作
默认安装后 markdown-writer 的快捷键不会自动注册，必须手动执行一次初始化命令。它不会像普通插件那样“装完即用”。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Markdown Writer: Create Default Keymaps，回车执行 - 这会在
keymap.cson中写入一组热键映射，比如ctrl-b加粗、ctrl-1插入 H1 - 如果之前改过
keymap.cson且有语法错误，Atom 可能静默忽略新规则——检查该文件是否能被 Atom 正常解析（无多余逗号、缩进正确）
项目级配置不生效的常见原因
markdown-writer 支持按项目单独配置，但依赖两个硬性前提：文件已保存 + 项目根目录已识别。
- 必须先将当前 Markdown 文件 保存为
.md后缀，未保存的临时文件无法触发路径解析 - 确保 Atom 是以项目方式打开的（
File → Add Project Folder），而不是只打开单个文件 - 项目根目录下放一个
_mdwriter.cson，内容如：{ "siteLocalDir": ".", "fileExtension": ".md" }，注意字段名不能拼错 - 修改配置后需执行
Window: Reload（或重启 Atom），否则缓存仍用旧配置
插入链接/图片时卡住或路径错乱
这个插件对路径处理很敏感，尤其在跨平台或嵌套子目录时容易出错。
- 插入链接用
[[触发，但光标必须在行首或空行，否则补全逻辑会失效 - 插入图片用
((，但要求当前文件已保存，否则siteLocalDir会退化为 Atom 安装目录，图片可能被存到奇怪位置 - 如果项目结构是
/blog/posts/2024-01-01-post.md，而图片想存到/blog/images/，就得在_mdwriter.cson里显式设"imageDirectory": "../images/" - Windows 用户注意路径分隔符：配置中必须用正斜杠
/或双反斜杠\，单反斜杠会被当转义字符吃掉
最易被忽略的一点：所有路径相关功能（模板生成、图片保存、链接相对化）都基于「当前文件已保存」和「Atom 当前窗口识别出 project root」这两个状态。随便双击打开一个 .md 文件，不加项目，不保存，就别指望 markdown-writer 能正常干活。
