Markdown Writer 快捷键不生效是因为未手动初始化热键，需通过命令面板执行“Markdown Writer: Create Default Keymaps”；所有功能依赖文件已保存且 Atom 识别 project root，否则路径解析、图片插入、模板生成等均失效。

markdown-writer 的快捷键为什么按了没反应

装完 markdown-writer 后快捷键不生效，不是插件坏了，而是它压根没注册热键。Atom 不会自动把快捷键写进配置，必须手动触发初始化。

• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板
• 输入并执行 Markdown Writer: Create Default Keymaps
• 检查 keymap.cson 文件是否被 Atom 正确加载：有语法错误（比如多逗号、缩进错位）会导致整段规则静默失效

常见误操作是改过 keymap.cson 后没验证格式，结果新规则全被跳过。

插入图片或链接时路径错乱或卡住

markdown-writer 对路径依赖极强，所有路径逻辑都基于两个前提：当前文件已保存 + Atom 窗口识别出 project root。缺一不可。

• 插入图片用 ((，但光标必须在空行或行首；否则补全引擎无法解析上下文
• 未保存的临时文件，siteLocalDir 会退化为 Atom 安装目录，图片可能被存到 C:UsersXXXAppDataLocaltompp-1.60.0 这类位置
• 项目结构为 /blog/posts/2024-01-01.md，想把图存到 /blog/images/，就得在项目根目录的 _mdwriter.cson 里显式写 "imageDirectory": "../images/"
• Windows 用户注意：配置中路径必须用正斜杠 / 或双反斜杠 \，单反斜杠 会被当转义符吃掉

表格和标题模板生成失败的常见原因

这个插件生成的表格默认用空格对齐，但 Atom 的 language-markdown 插件对格式极其敏感——少一个空格、多一个制表符，预览就可能崩成纯文本。

OCR 文档识别转 Markdown（WiseOCR）

WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi

下载

• 标题模板（如 Ctrl+1）要求光标必须在行首，且该行不能已有内容，否则会把标题插在中间导致语法错乱
• 表格生成后，务必用空格而非 Tab 键对齐竖线；Atom 不识别 Tab 对齐的 Markdown 表格
• 如果用了自定义模板（比如博客草稿），模板文件需放在项目根目录的 .templates/ 下，且文件名要匹配配置里的 templatePath
• 模板中变量如 {{date}} 或 {{title}} 只在新建文件时展开，已存在的文件不会重写元数据

项目级配置 _mdwriter.cson 不生效

很多人把配置文件放对了位置却没效果，问题往往出在 Atom 的“项目识别”机制上。

• 必须通过 File → Add Project Folder 打开整个文件夹，而不是双击单个 .md 文件——后者 Atom 不认为是项目，_mdwriter.cson 直接被忽略
• 文件必须已保存为 .md 后缀，未保存的 untitled 文件无法触发路径解析，所有相对路径功能（图片、链接、模板）全部瘫痪
• 修改 _mdwriter.cson 后必须执行 Window: Reload 或重启 Atom，缓存不刷新，旧配置继续跑
• 字段名大小写和拼写必须完全匹配文档，比如写成 image_dir 或 imagedirectory 都无效，只能是 imageDirectory

最常被忽略的一点：所有写作辅助功能——从插入图片到生成带 front matter 的草稿——都卡在「文件已保存」和「project root 已识别」这两个开关上。随便打开一个未保存的 .md 文件，就别指望 markdown-writer 能干任何事。