预览卡顿主因是默认高频刷新、Mermaid实时渲染、CSS换行及侧边同步滚动；应配置debounce延时、禁用自动渲染、修改white-space为pre-wrap、改用独立窗口预览。

预览卡顿？先关掉实时刷新 debounce

VSCode 内置预览或 Markdown Preview Enhanced 默认开启高频实时更新，编辑时每敲一个字符都触发重渲染，尤其文档超过 100 行或含大量 Mermaid/数学公式时，CPU 占用飙升、滚动滞后。这不是硬件问题，而是策略过激。

实操建议：

Video To Markdown

分析任意YouTube、Facebook或Instagram视频链接，结合AI视觉分析提取的画面，生成全面的Markdown参考文档。

下载

• 打开设置（Ctrl+Shift+P → 输入 Preferences: Open Settings (JSON)）
• 添加配置项："markdown-preview-enhanced.liveUpdateDebounceMs": 500（单位毫秒，推荐 300–800）
• 若用原生预览，该参数无效；此时应禁用插件的自动刷新，改用手动触发（快捷键 Ctrl+K V）

Mermaid / PlantUML 图表拖慢预览？别让浏览器现场渲染

每次预览都调用 Mermaid.js 或 PlantUML 服务解析语法并生成 SVG，是最大性能黑洞。尤其当文档里有 5+ 张流程图，且你正快速滚动或修改文本时，主线程频繁被阻塞。

实操建议：

• 在 settings.json 中关闭自动渲染："markdown-preview-enhanced.mermaid.enabled": false
• 需要查看图表时，手动执行命令：Markdown Preview Enhanced: Render Mermaid in Current Editor
• 更彻底的方案：把 Mermaid 图单独存为 .mmd 文件，用专用插件（如 Mermaid Preview）独立打开——不混在 Markdown 流程里

长代码块横向滚动？CSS 一行就能修好

原生预览中 pre 和 code 元素默认 white-space: pre，长命令、JSON 或 URL 会撑宽容器，强制出现横向滚动条。这不是 bug，是 CSS 的默认行为，但严重影响阅读节奏。

实操建议：

• 找到或新建全局样式文件：C:\Users\{用户名}\.crossnote\style.less（Windows）或 ~/.crossnote/style.less（macOS/Linux）
• 插入以下规则（仅作用于预览窗口）：

  .markdown-preview.markdown-preview {
    pre, code {
      white-space: pre-wrap;
      word-break: break-all;
    }
  }

• 注意：必须重启 VSCode 才生效；若用深色主题，可额外加 code { background: #2d2d2d; } 统一底色

侧边预览越用越卡？换到新窗口或禁用同步滚动

侧边预览（Ctrl+Shift+V）和编辑器共享渲染进程，启用同步滚动后，VSCode 需持续计算光标位置映射关系，小屏或低配机器上极易掉帧。这不是内存泄漏，是设计取舍。

实操建议：

• 按 Ctrl+K V 将预览弹出为独立窗口（脱离侧边栏），性能提升最明显
• 如必须侧边预览，关闭同步滚动：右键预览区域 → Toggle Scroll Sync
• 进阶控制：在设置中禁用 "markdown.preview.scrollPreviewWithEditor": false，彻底解除绑定

真正影响体验的，往往不是功能缺不缺，而是“默认开启”和“实际需要”之间的错位——比如 Mermaid 渲染、同步滚动、高频刷新，全都是默认开、但多数人并不每分钟都需要。关掉它们，比升级硬件更快见效。