在macos上配置markdown实时预览需按场景选方案:系统级快速查看用qlmarkdown(空格键预览),编辑写作用vscode+扩展(cmd+shift+v侧边预览并配autosave),专注阅读校对用markoff 2(拖入即实时渲染、字数统计)。
在 macos 上配置 markdown 实时预览,关键不是“装一个万能工具”,而是按使用场景选对方案:系统级快速查看用 qlmarkdown,编辑写作时用 vscode + 扩展,专注预览体验可选 markoff 2。三者不冲突,常搭配使用。
访达中空格即看:安装 QLMarkdown
这是最轻量、最符合 macOS 直觉的方案——选中 .md 文件,按空格键直接预览,无需打开任何应用。
- 推荐用 Homebrew 安装:
brew install --cask qlmarkdown(如未装 Homebrew,先运行官方一键脚本) - 手动安装:去 QLMarkdown 发布页 下载最新版 .app,拖入
/Applications,首次右键“打开”绕过签名限制 - 安装后必须双击运行一次 QLMarkdown.app 激活插件;之后在访达中选中 .md 文件,按空格即可预览
- 若无效,重启 Finder(Option+Cmd+Esc → 重新启动),或终端执行
qlmanage -r重建索引
VSCode 中边写边看:启用侧边预览 + 必备扩展
VSCode 是开发者主力编辑器,它的 Markdown 预览默认需手动触发,但稍作配置就能接近“实时”效果。
ApiPost是一个支持团队协作,支持模拟POST、GET、PUT等常见请求,并可直接生成文档的API调试、管理工具,ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具,ApiPost官方版界面美观大方,功能强劲实用,支持团队协作,支持模拟POST、GET、PUT等常见请求,是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键
- 基础预览:打开 .md 文件后,按 Cmd+Shift+V(macOS),预览窗自动出现在右侧;修改后保存(Cmd+S)即刷新
- 让预览更智能:安装 Markdown All in One(Yu Zhang 开发),开启设置
markdown.preview.autoShowPreviewToSide,再配合files.autoSave: "afterDelay",基本实现“打完字稍停就更新” - 支持公式与图表:该扩展默认启用 LaTeX 渲染;如需 Mermaid 流程图,额外安装 Mermaid Preview 或启用
markdown.preview.mermaid(VSCode ≥ 1.86) - 调整位置:首次预览若没在右侧,拖动预览标签页到编辑器右边缘,出现蓝线后松手,之后都会记住这个布局
独立专注预览:用 Markoff 2 做纯阅读/校对工具
如果你常要对照多个文档、检查排版细节,或希望有字数统计、自动刷新等贴心功能,Markoff 2 是专为 macOS Big Sur 及更新系统打造的现代预览器。
- 它不编辑、不保存,只专注渲染:拖入任意 .md 文件,内容实时显示,保存源文件后预览自动更新
- 界面极简,顶部状态栏显示字数、字符数,适合审阅 README、技术文档初稿
- 开源免费,基于 Swift 和 CommonMark,解析准确,兼容 GitHub 风格锚点和中文标题
- 获取方式:GitHub 克隆项目后用 Xcode 12+ 直接运行,或等待社区打包的正式版发布
不复杂但容易忽略:QLMarkdown 解决“随手一看”,VSCode 解决“边写边调”,Markoff 2 解决“静心一读”。根据当前任务切换工具,比强求一个“全能方案”更高效。










