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。缺一不可。
OCR 文档识别转 Markdown（WiseOCR）
下载
WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi
- 插入图片用
((，但光标必须在空行或行首；否则补全引擎无法解析上下文 - 未保存的临时文件，
siteLocalDir会退化为 Atom 安装目录，图片可能被存到C:UsersXXXAppDataLocaltompp-1.60.0这类位置 - 项目结构为
/blog/posts/2024-01-01.md，想把图存到/blog/images/，就得在项目根目录的_mdwriter.cson里显式写"imageDirectory": "../images/" - Windows 用户注意：配置中路径必须用正斜杠
/或双反斜杠\，单反斜杠会被当转义符吃掉
表格和标题模板生成失败的常见原因
这个插件生成的表格默认用空格对齐，但 Atom 的 language-markdown 插件对格式极其敏感——少一个空格、多一个制表符，预览就可能崩成纯文本。
- 标题模板（如
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 能干任何事。
