必须先禁用 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 插入图片，本质是调用系统文件选择器，选中后生成 ![alt](path/to/file.png)。但它不会自动复制或重命名图片，路径是你选中的原始路径。这意味着：如果你截图保存在 /Downloads/screenshot.png，而 Markdown 文件在 /notes/ 下，预览时就会显示红叉。解决办法只有两个：

Markdown Docs Full-Text Search

使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索，适用于需要快速、高效搜索大量 Markdown 文章的场景。

下载

• 手动把图片拖进 Markdown 所在目录，再用 shift-ctrl-I 选它
• 改用 markdown-image-paste 插件（Ctrl+V 粘贴截图，自动存同目录）

链接插入（shift-ctrl-K）支持从剪贴板读取 URL，但默认不填 title，需手动补上双引号内的描述，否则生成的是 [text](url) 而非 [text](url "title")，影响可访问性。

项目级配置和 _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，否则新配置不会加载。