LaTeX equation references ZH

LaTeX 公式引用

指南首页 · English

2.15.4 新增。感谢 Innovaspire 在 PR #2 中提供的原始实现。

显示公式与引用

$$
E=mc^2 \label{eq:energy}
$$

$$
\eqref{eq:energy}
$$

\eqref 显示带括号的编号，\ref 显示不带括号的编号。跨文件可写 \eqref{Chapter One#^eq:energy}；正文中可写 [[Chapter One#^eq:energy]]，使用设置中的公式引用格式。

LaTeX 标签由插件解析，含冒号的标签不是 Obsidian 原生块 ID。如果需要关闭插件后仍能跳转，请给公式添加真实的 ^block-id。生成的 Markdown 目录只使用真实块锚点，否则退回章节或笔记链接。

阅读视图与实时预览都支持点击引用。导出 HTML/PDF 时，纳入导出范围的目标保留内部链接；多文件导出遵守所选合订本编号方式。逐行引用目前跳到所在公式块，不精确定位到某一行。

逐行编号

$$
\begin{align*}
a &= b \label{eq:first} \\
c &= d \label{eq:second} \\
e &= f \notag \label{eq:quiet}
\end{align*}
$$

$$
\eqref{eq:first}\quad\eqref{eq:second}
$$

在支持的顶层对齐环境中添加行标签，会启用逐行编号。同一行多个标签共享编号；不同目标重名会判为歧义；不同文件可以重名，但引用时应明确文件路径。

公式编号设置	行为
全部	每个有效数学行都编号，包括未写标签的行。
仅被引用	只给通过行标签被引用的行编号。
关闭	不分配自动行号。

\tag{A} 手动指定编号；\notag / \nonumber 取消该行的自动编号。标签本身不会绕过编号设置。引用未编号公式时显示“未编号”，并在“检查学术引用”中提示；目标不存在时显示 ??。仅声明标签但不引用，不会产生未编号警告。

没有行标签的旧笔记保留整块编号。split、multline 表示分成多行的同一个公式，仍保留一个编号。嵌套环境中的标签和未支持的环境不会启用顶层逐行编号。注释中的标签、编号和换行命令不生效。

快捷插入

使用“插入定理、公式或图表引用”或引用补全。在 $...$ 或 $$...$$ 内选择公式会插入 \eqref，其他环境使用 \ref；正文中使用双链。行标签会作为独立目标供选择。选择尚无标签的对象时，只为该对象添加原生块 ID，并保留对未保存内容的保护。

限制

2.15.5 已支持行内 $...$ 的 LaTeX 引用；标签定义仍放在显示公式或原生块 ID 中。关闭插件后，Obsidian 无法解析虚拟 LaTeX 标签。PDF 打印仍仅支持桌面端；引用及 HTML 导出可在移动端使用。

行内引用（2.15.5）

例如：由 $\eqref{eq:energy}$ 可得结论。 行内引用参与“仅被引用公式编号”，支持跨文件和导出链接。阅读视图及未处于编辑状态的实时预览会转换显示；编辑源码时保留原始命令。