.md文件双击显示乱码是因macOS默认不渲染Markdown；装QLMarkdown后在访达中选中按空格键即可秒级预览排版效果，推荐用brew install --cask qlmarkdown一键安装，或手动下载运行激活。
别人发来一个 .md 文件，双击打开全是井号、星号、方括号，像乱码一样——这不是文件坏了，而是 macOS 默认不渲染 Markdown；你不需要打开浏览器或装完整编辑器，只要在访达里选中它，按空格键就能立刻看到带标题、列表、代码块的排版效果，整个过程不到1秒。
用 QLMarkdown 实现系统级空格预览
这是最轻量、最符合 macOS 直觉的方案：不启动任何应用，不切换窗口，选中 .md 文件→按空格键→格式化内容直接弹出。
方法一：Homebrew 一键安装（推荐）
打开终端，粘贴并执行：
brew install --cask qlmarkdown
安装完成后，无需重启、无需额外设置，立刻生效。如果你还没装 Homebrew，先运行官方脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
方法二：手动安装（无命令行基础可用）
去 QLMarkdown 官方发布页 下载最新 .dmg 文件 → 双击打开 → 将 QLMarkdown.app 拖入「应用程序」文件夹 → 右键点击图标 → 选择“打开”绕过未签名警告 → 双击运行一次该 App（这一步必须做，否则系统不会注册插件）。
验证是否成功：
在访达中找一个 .md 文件，单击选中 → 按空格键 → 若看到带层级标题、加粗文字、代码块背景色的渲染效果，说明已就绪；若只显示原始文本，执行 qlmanage -r 重建索引，或按 Option+Cmd+Esc 重启访达。
用 VSCode 边写边看：侧边实时预览工作流
当你不只是“看”，还要“改”，QLMarkdown 就不够用了——VSCode 的预览是双向同步的，改完保存，右侧立刻刷新，还能渲染公式、Mermaid 图表和本地图片。
将 Markdown 标题大纲转换为 KMind 主题思维导图，支持主题预设、布局、连线方式、深色模式及彩虹分支，并可导出 PNG 或 SVG 图像。
第一步：启用基础预览
打开任意 .md 文件 → 按 Cmd+Shift+V → 预览窗自动出现在右侧；注意：文件必须已保存（.md 后缀，不能是 .txt 或无后缀），且右下角状态栏显示“Markdown”语言模式，不是“Plain Text”。
第二步：让预览真正跟手
打开设置（Cmd+,）→ 搜索 files.autoSave → 设为 afterDelay；再搜索 markdown.preview.refreshOnSaveOnly → 关闭它（设为 false）。这样打字停顿半秒就会自动刷新，不用每敲一行都按 Cmd+S。
第三步：增强功能（按需选装）
装 Markdown All in One：支持自动生成目录、$E=mc^2$ 公式、快捷键补全；
如需 Mermaid 流程图或 PlantUML，改用 Markdown Preview Enhanced，但不要和 All in One 同时启用——二者会冲突。
用 FastMD 实现悬停即看：菜单栏极简预览
适合每天要扫十几份 README、笔记、配置文档的人：不点、不选、不按空格，鼠标在 .md 文件上悬停约 1 秒，浮动面板直接弹出，还支持双击某段已渲染内容回写源文件。
安装只需三步：
① 打开终端 → 输入 git clone https://github.com/weiyangzen/fastmd.git
② 进入项目目录：cd fastmd
③ 构建运行：swift build --package-path apps/macos && swift run --package-path apps/macos
完成后，FastMD 图标会出现在菜单栏，点击「Preferences」可设置监听的文件夹路径。
注意：首次运行需在「系统设置 → 隐私与安全性 → 完全磁盘访问」中允许 FastMD；它不修改原文件，所有编辑仍需保存到源 .md 中才生效。
