Obsidian 插件：MyST Reader

概述

MyST Reader 允许在 Obsidian 笔记中直接渲染 MyST Markdown 的指令、数学公式、图表及嵌套结构，同时保持源文件不变。它专为技术笔记、方程和多语言课程材料设计，支持希伯来语等语言。插件在“阅读视图”和“实时预览”中自动解析支持的 MyST 块，无需额外面板或命令，让你能在 Obsidian 中直接查看 Jupyter Book 或 Sphinx 风格的文档内容，而无需切换工具。

典型场景包括编写包含复杂公式的技术文档或课程讲义。例如，你可以使用 admonition 指令创建带有提示类的提示框，并在其中嵌入 LaTeX 数学公式，插件会将其渲染为原生的提示调用块。另一个例子是使用嵌套的 note 和 warning 指令来组织多层级的注意事项，在实时预览中，当光标移出这些块时，它们会显示为预览效果，移入时则显示源码以便编辑。

与同类插件相比，MyST Reader 的特色在于其对 MyST 子集的支持以及对交互式 HTML 的处理。它支持 raw HTML 指令，允许加载本地 HTML 文件并在隔离的 iframe 中运行脚本，甚至自动注入 MathJax 以支持数学渲染。此外，它支持多种内联角色如 {math}、{code} 和 {ref}，以及本地锚点链接。插件不执行代码块，仅用于展示，确保了安全性。

使用前需注意，该插件仅支持 MyST 的文档化子集，并非完整的 MyST 解析器或 Jupyter/Sphinx 运行时。它不支持跨文档标签索引、自动编号、Sphinx 域、网格布局以及嵌套超过 32 层的指令。对于需要完整构建书籍或复杂 Sphinx 功能的用户，建议仍使用原有工具链。此外，虽然插件不写入笔记或收集遥测数据，但嵌入的 HTML 脚本可能访问外部网络，因此仅应嵌入可信的 HTML 内容。