必须先禁用 Atom 自带的 markdown-preview，因其与 markdown-writer 功能重叠且互不兼容，导致表格对齐、标题跳转、元数据插入失效，且 ctrl-1 插入 H1 时预览窗口易卡死；需手动关闭并替换为 markdown-preview-enhanced 或 markdown-preview-plus。
为什么必须先禁用 Atom 自带的 markdown-preview
Atom 默认启用的 markdown-preview 与 markdown-writer 存在功能重叠且互不兼容：它不支持 markdown-writer 的表格对齐辅助、标题大纲跳转、自动插入元数据等关键能力。更直接的问题是——当你按下 ctrl-1 插入 H1 标题时，如果 markdown-preview 激活中，预览窗口可能卡死或不刷新。必须进 Packages → markdown-preview → Settings，把 Enable 开关设为 disabled；再装 markdown-preview-enhanced 或 markdown-preview-plus 替代。
markdown-writer 表格和标题操作的实际手感
它不是“生成表格”，而是帮你维持表格可编辑性。比如输入 | Name | Age | 后回车，插件会自动补全分隔行 | :-- | :-- |；光标停在第二行第一个单元格，按 tab 直接跳到下一列。标题快捷键（ctrl-1 到 ctrl-6）会在当前行前后加空行并插入对应级别标题，避免手敲 ### 后忘记空行导致渲染失败。但注意：ctrl-1 不会覆盖已有内容，只作用于空行或光标所在行——若光标在文字中间，它会把整行转成 H1，而不是只加前缀。
图片、链接、脚注的插入逻辑和路径陷阱
markdown-writer 的 shift-ctrl-I 插入图片，本质是调用系统文件选择器，选中后生成 。但它不会自动复制或重命名图片，路径是你选中的原始路径。这意味着：如果你截图保存在 /Downloads/screenshot.png，而 Markdown 文件在 /notes/ 下，预览时就会显示红叉。解决办法只有两个：
- 手动把图片拖进 Markdown 所在目录，再用
shift-ctrl-I选它 - 改用
markdown-image-paste插件（Ctrl+V 粘贴截图，自动存同目录）
链接插入（shift-ctrl-K）支持从剪贴板读取 URL，但默认不填 title，需手动补上双引号内的描述，否则生成的是 [text](url) 而非 [text](url "title")，影响可访问性。
将任意网站转换为文件系统，自动抓取网站并将页面挂载为 Markdown 文件，可使用 grep、diff、cat 等标准 Unix 命令进行搜索、比较、读取和浏览。
项目级配置和 _mdwriter.cson 的生效条件
markdown-writer 的博客元数据（如 layout: post、tags:）依赖 siteLocalDir 和 fileExtension 配置。你不能只在全局 config.cson 里写死一个路径——那样所有项目都套用同一套模板。正确做法是在每个博客根目录下放一个 _mdwriter.cson，内容类似：
{
"siteLocalDir": ".",
"fileExtension": ".md",
"frontMatter": {
"layout": "post",
"tags": []
}
}
这个文件只在你用 Atom 打开该目录（即 File → Add Project Folder）时才被识别。如果只是单个文件拖进 Atom，_mdwriter.cson 完全不生效。另外，修改后必须执行 Window: Reload，否则新配置不会加载。
