Obsidian 插件：Mermaid Pilot

概述

Mermaid Pilot 旨在解决 Obsidian 中 Mermaid 图表查看体验受限的问题，核心功能是提供流畅的缩放、平移及全屏浏览体验。它允许用户在阅读视图和实时预览模式下，无需离开当前笔记页面即可深入查看图表细节。无论是通过鼠标拖拽还是触摸手势，都能实现对图表的精细控制，让复杂的流程图或架构图在屏幕上清晰呈现，避免了原生查看器中图表过小或无法灵活调整视角的痛点。

典型使用场景包括审阅大型系统架构图或梳理复杂的项目依赖关系。例如，当你在笔记中嵌入了一张包含数十个节点的 UML 类图时，可以直接按住鼠标右键上下拖动来放大特定区域，仔细查看类名和属性；或者在平板设备上，双击图表进入全屏模式，用单指拖动查看不同部分。这种交互方式让静态的图表变得动态且可探索，极大地提升了阅读长文档时理解复杂逻辑的效率。

相比其他同类插件，Mermaid Pilot 的特色在于其对多设备输入的全面支持以及独立的视图状态管理。每个图表都拥有独立的缩放和位置记忆，缩放范围覆盖 20% 至 500%，且退出全屏后能自动恢复之前的视图状态。此外，它巧妙地处理了交互冲突，确保右键菜单、快捷键组合以及笔记内的链接点击不受干扰，同时支持键盘焦点操作，使得鼠标和键盘用户都能获得一致且高效的体验。

使用前需注意，该插件的缩放和位置状态是临时的，不会保存到你的笔记或插件设置中，当 Obsidian 重新渲染图表时，视图会重置。此外，虽然触摸控制已通过自动化测试，但在物理移动设备上的实际体验尚待验证。如果你需要永久保存图表的特定缩放状态，或者依赖插件自动同步图表布局，那么 Mermaid Pilot 可能不适合你的需求，因为它主要侧重于临时的交互式查看而非状态持久化。