Obsidian 插件：HTML Entity Renderer

概述

HTML Entity Renderer 旨在解决 Obsidian 实时预览模式下 HTML 字符实体无法直接显示的问题。它能在不修改 Markdown 源文件的前提下，将 ©、& 等实体渲染为对应的可见字符，如 © 或 &。这种“所见即所得”的显示方式让笔记内容更加直观，同时保留了源文本的完整性，方便后续编辑和版本管理。

典型使用场景包括撰写包含版权信息的文档或处理特殊排版需求。例如，在笔记中直接输入 Fish & Chips，预览时即可看到清晰的 “Fish & Chips”，无需手动输入特殊符号。又如，使用 — 代替破折号，既保证了源文件的 ASCII 兼容性，又能在阅读时获得优雅的排版效果，特别适合对文本格式有严格要求的写作场景。

相比其他类似插件，该工具的核心特色在于其严格的边界控制与编辑体验优化。它仅在实时预览中生效，源代码模式、行内代码及代码块中的实体保持原样，避免干扰代码逻辑。此外，当光标移入已渲染的实体时，会自动显示原始源码以便编辑，解决了“看到结果却难改源码”的痛点。对于不可见字符或无效引用，插件也会保留源码显示，确保内容始终可见且可编辑。

使用前需注意，该插件仅改变显示效果，不影响底层数据。因此，全文搜索功能匹配的是源码文本（如 —）而非渲染后的字符，复制选区时粘贴出的也是源码而非渲染字符。如果你需要直接操作渲染后的字符，或者依赖基于渲染文本的自动化搜索与复制流程，此插件可能无法满足需求。它更适合重视源文件纯净度、且能接受源码搜索逻辑的用户。