必须启用Live Preview配置或换用markdown-preview-plus并勾选“Enable Live Preview”，因原生插件仅保存后刷新；图片路径需用img/logo.png格式，禁用./或../；导出HTML前应先在浏览器中验证样式。
Atom里Markdown预览不自动刷新怎么办
默认安装的markdown-preview插件只在保存文件后触发预览更新，编辑过程中修改内容不会实时反映——这不是bug，是设计如此。想边写边看效果，得手动触发或改配置。
- 按
Ctrl+Shift+M（Windows/Linux）或Cmd+Shift+M（macOS）可手动刷新当前预览窗 - 如果已打开预览窗但内容没变，先确认焦点是否在编辑器主窗口（而不是预览窗），否则快捷键无效
- 部分用户误以为
markdown-preview-plus能自动刷新，其实它默认也关闭实时渲染；需在设置里勾选Enable Live Preview
用markdown-preview-plus替代原生插件更可靠
原生markdown-preview功能简陋、长期未维护，而markdown-preview-plus支持数学公式、目录生成、自定义CSS等，且兼容性更好。但它不是开箱即用，得主动配置。
- 卸载原生
markdown-preview（避免冲突），再通过Atom设置界面搜索安装markdown-preview-plus - 安装后重启Atom，否则快捷键
Ctrl+Shift+C可能不生效 - 默认预览快捷键是
Ctrl+Shift+C，不是M；若冲突可在keymap.cson里重映射，例如：'.editor:not(.mini)':<br> 'ctrl-shift-m': 'markdown-preview-plus:toggle'
预览中图片路径不显示？检查相对路径写法
Atom的Markdown预览对路径解析严格，能工作，但或可能失败——因为预览服务以当前文件所在目录为根，不支持./前缀，也不向上跨级。
pdf文档转markdown
下载
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
- 一律用
这类纯相对路径，不要加./ - 如果图片在上层目录，把文件挪到同级或子目录，Atom不支持
../ - 绝对路径
file:///开头的链接会被拦截（安全策略），预览里直接失效
导出HTML时样式丢失或乱码
markdown-preview-plus的“Export to HTML”功能默认用GitHub风格CSS，但中文字符可能因字体缺失显示方框，且自定义CSS不自动注入到导出文件中。
- 导出前先在预览窗右键 →
Open in Browser，确认浏览器里显示正常再导出 - 若要保留自定义样式，得手动复制
markdown-preview-plus的CSS到导出HTML的<style></style>块里 - Windows用户导出HTML后用记事本打开可能乱码，建议用VS Code或Atom本身打开，编码是UTF-8 BOM
Atom的Markdown预览本质是本地服务渲染，所有路径、样式、编码问题都源于这个前提——它不模拟服务器环境，也不修正你写的路径逻辑。
