Atom原生支持.md文件,双击或拖入即自动语法高亮并识别为Markdown;若右下角显示Plain Text,点击切换即可;推荐用Ctrl+Alt+M替代被劫持的Ctrl+Shift+M唤起预览,需在keymap.cson中绑定;默认预览不支持公式与Mermaid,须装markdown-preview-enhanced;高频操作可用table/code/img等snippets快速插入;导出PDF需按系统配置phantomjs(Windows)或Chrome(macOS),并设置中文字体以防乱码。

直接打开.md文件就能写,不用额外配置
Atom对Markdown原生支持,只要双击或拖拽一个.md文件进去,语法高亮、标题识别、列表缩进就自动生效。不需要手动切换语言模式——右下角显示“Markdown”即表示已正确识别。如果显示“Plain Text”,点一下那里,从弹出菜单选Markdown即可。
实时预览别用Ctrl+Shift+M,优先改用快捷键绑定
默认快捷键Ctrl+Shift+M在部分系统(尤其是Linux桌面环境)常被窗口管理器劫持,按了没反应。更可靠的做法是:打开Keymap.cson(通过Ctrl+Shift+P → 输入Application: Open Your Keymap),加一行:
'.editor': 'ctrl-alt-m': 'markdown-preview:toggle'
这样用Ctrl+Alt+M就能稳定唤出右侧预览窗,且编辑时自动同步滚动。
- 预览窗不支持数学公式、Mermaid流程图等扩展语法,需要装
markdown-preview-enhanced插件才可用 - 如果预览内容错位或样式异常,检查是否启用了
markdown-preview插件本身(不是它的增强版)——二者冲突,只能留其一
插入表格、代码块、图片这些高频操作别手敲
Atom内置snippets机制,输入缩写后按Tab自动展开:
-
table+Tab→ 生成7列×3行的Markdown表格骨架 -
code+Tab→ 插入带语言标识的代码块,光标停在语言名位置,输php或json再Tab可补全 -
img+Tab→ 生成结构,光标先停在alt处,填完再Tab跳到src
这些片段在~/.atom/snippets.cson里可自定义,但日常够用,不建议过早修改。
导出PDF前先确认渲染引擎和字体路径
用markdown-pdf插件导出PDF时,常见失败不是因为插件没装,而是底层依赖缺失:
- Windows用户必须安装
phantomjs并确保其路径加入PATH,否则报错spawn phantomjs ENOENT - macOS上
phantomjs已弃用,应改用markdown-preview-enhanced+Chrome导出(需本地装好Chrome,并在插件设置里勾选Use Chrome as PDF renderer) - 导出的PDF中文乱码?检查插件设置里的
pdf-font-family是否设为"Noto Sans CJK SC"或系统已安装的中文字体名
轻量级文档的核心是“写得快、看得清、传得稳”,Atom能做到这三点,但每一步都卡在细节——比如预览快捷键冲突、PDF字体路径、snippet触发时机。这些地方不调通,再多插件也白搭。

















