macOS Markdown实时预览需分系统级（QLMarkdown空格预览）和开发级（VSCode双向同步）两类：前者轻量快捷，后者支持公式图表；二者分工明确，不可替代。
在 macos 上实现 markdown “实时预览”，需区分两种场景：一种是**系统级快速查看（空格键预览）**，轻量、无需打开编辑器；另一种是**开发写作环境中的双向同步预览（如 vscode）**，支持编辑时即时渲染、公式图表等。两者目标不同，配置路径也不同——没有单一工具能同时完美覆盖全部需求。
用 QLMarkdown 实现系统级空格预览
这是最轻量、最符合 macOS 直觉的方案：选中 .md 文件，按空格键立即看到带格式的渲染效果（标题、列表、代码块、链接等），不启动任何应用。
- 推荐用 Homebrew 安装：终端执行
brew install --cask qlmarkdown - 手动安装也行：下载
QLMarkdown.app拖入/Applications，首次右键 → “打开”绕过未签名拦截 - 安装后必须双击运行一次 QLMarkdown.app，才能激活 Quick Look 扩展
- 验证：在访达中选一个 .md 文件，按空格键 —— 若显示排版效果即成功；若只显示原始文本，执行
qlmanage -r重建索引，或重启访达（Option + Command + Esc）
用 VSCode 搭建开发级实时预览工作流
QLMarkdown 只负责“看”，VSCode 才负责“写+看同步”。它原生支持 Markdown 预览，但默认不自动刷新，需合理配置才能接近“实时”体验。
Markdown to PDF Converter (v2.0)
下载
离线Markdown转PDF转换器，基于Pandoc与WeasyPrint，支持完整Unicode及本地表情缓存，可将Markdown转为专业级PDF...
- 基础操作：打开 .md 文件后，按 Cmd+Shift+V（macOS）即可在右侧打开预览窗格
- 让预览更“跟手”：在设置中搜索
markdown.preview.refreshOnSaveOnly，设为 false；再开启files.autoSave（建议选afterDelay） - 增强结构化写作：安装扩展 Markdown All in One（官方推荐），自动生成目录、支持数学公式（$$E=mc^2$$）、快捷键补全等
- 如需 Mermaid 图表或 KaTeX 公式：改用 Markdown Preview Enhanced，但它会接管预览逻辑，不建议与 All in One 同时启用
关键细节别忽略
很多“预览不生效”问题其实和插件无关，而是卡在基础环节：
- 文件必须已保存：VSCode 预览读取的是磁盘文件，未保存内容不会渲染（尤其影响本地图片路径、CSS 引用）
- 后缀必须严格为 .md 或 .markdown：.txt、.mdown、无后缀都不识别；大小写敏感（.MD 不行）
- 检查语言模式：右下角状态栏确认显示 “Markdown”，不是 “Plain Text”；点一下可切换
- 快捷键冲突常见于 Vim/Emacs 插件：临时禁用它们，用命令面板（Cmd+Shift+P）搜 “Open Preview to the Side” 测试是否可用
不推荐“全自动实时”陷阱
所谓“键入一个字就刷新一次”的真·实时预览，在 VSCode 中并不存在原生支持，强行追求反而导致卡顿或插件冲突。实际高效的工作流是：保持 autoSave + Cmd+Shift+V 预览 + 必要时手动 Ctrl+S 强制刷新。QLMarkdown 负责快速查文档，VSCode 负责专注写文档——分工明确，体验更稳。
