1. Quick Latex 在 Obsidian 里到底解决什么问题
Quick Latex 是 Obsidian 的一个公式输入增强插件，核心能力是把「冒号左边的短码 + 空格」实时替换成「冒号右边的 LaTeX 片段」，并且用#cursor、#tab标记替换后光标该停在哪。它解决的是笔记里写公式太慢的问题：你不用每次手打\begin{aligned}、\frac{}{}、\sum\limits_{}^{}，只要敲ali加空格，环境骨架就出来了，光标自动落在第一个空位。
适合谁用：经常在 Obsidian 里记数学、统计、机器学习推导的人；写论文草稿、刷题笔记、课程整理的人；以及希望把公式输入速度压到接近手写的人。它不负责渲染，渲染仍由 Obsidian 内置的 MathJax 完成，所以插件配置和渲染链路是两件事，这点后面会反复提到。
我自己的使用场景是：一边看教材一边记推导，公式密度很高，如果每个\frac都手打，思路会被打断。Quick Latex 的短码机制让输入变成「敲缩写 + 空格 + 填内容」，节奏顺很多。这篇笔记按 Setting 项、快捷键、片段配置、渲染链路验证、常见报错排查的顺序写，方便你直接抄，也方便我以后持续更新。
需要先明确一个边界：Quick Latex 只做文本替换，它不会调用任何模型，也不会联网。所以「把 API endpoint 改到 TaoToken」这件事，严格说不是 Quick Latex 的配置项，而是当你想在 Obsidian 里用 AI 辅助生成或润色公式、或者用支持自定义 endpoint 的 AI 插件时，把请求指向 TaoToken 的 API 地址。两者配合起来，才是「公式输入 + 公式生成/校验」的完整链路。下面会分开讲清楚，避免你把两套配置混在一起。
2. TaoToken 前置准备与 Obsidian 端接入定位
TaoToken 是一个大模型 API 聚合服务，官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api 。它的作用是让你用一个 Key、一个 Base URL，就能调用多家模型，省去分别注册和切换的麻烦。对 Obsidian 用户来说，典型用途是：用 AI 插件生成 LaTeX、把自然语言描述转成公式、或者对已有公式做解释和纠错。
先说清楚定位：Quick Latex 本身不需要 Key，也不需要网络。你只有在用「支持自定义 API 的 Obsidian AI 插件」时，才需要填 TaoToken 的 Base URL 和 Key。常见的这类插件包括 Copilot for Obsidian、Text Generator、以及一些支持 OpenAI 兼容接口的插件。它们的配置逻辑一致：Base URL 填https://taotoken.net/api，API Key 填你在控制台创建的 Key，Model ID 填你要用的模型名。
拿 Key 的路径：打开 https://taotoken.net/api-keys ，登录后创建 Key，复制保存。注意 Key 只在创建时完整显示一次，丢了就重建。模型列表和可用模型名可以在 https://taotoken.net/doc 查，或者在 https://taotoken.net/console 里看账户和用量。如果你只是想先验证模型能不能通，可以用 https://taotoken.net/models 里的对话页面试一条消息，确认 Key 和模型都正常，再回到 Obsidian 配置。
这里有个容易踩的坑：很多人把 Base URL 填成https://taotoken.net/api/v1或漏掉/api。正确写法是https://taotoken.net/api，具体路径由插件自己拼接。如果你用的插件要求填完整 endpoint，通常是https://taotoken.net/api/v1/chat/completions，但大多数插件只需要 Base URL。填错的表现是 404 或连接失败，不是 401，注意区分。
另外，TaoToken 不是「中转」意义上的灰色服务，它是一个正常的 API 聚合平台，你按用量付费，Key 和账户都在自己手里。配置时不要把它和任何网络工具混为一谈，也不需要那些东西。Obsidian 插件走的是标准 HTTPS 请求，能正常访问外网 API 即可。
3. 可复制的 Quick Latex Setting 与插件配置片段
这一节是全文最核心的部分，分两块：Quick Latex 的短码配置，以及 AI 插件的 API 配置。两块都可以直接复制。
3.1 Quick Latex 短码配置
Quick Latex 的设置入口在 Obsidian 设置 → 第三方插件 → Quick Latex。它的核心配置项是「Shortcuts」，也就是短码映射表。格式是每行一条：短码:替换内容，用#cursor表示替换后光标位置，#tab表示按一次 Tab 后光标跳到的位置，多个#tab按顺序跳。
下面是我常用的环境类短码，注意这些内容在设置里要放在代码块之外直接粘贴，不要带反引号：
ali:\begin{aligned} #cursor\end{aligned} cases:\left\{\begin{aligned}&#cursor\end{aligned}\right. pma:\begin{pmatrix}#cursor\end{pmatrix} bma:\begin{bmatrix}#cursor\end{bmatrix} vma:\begin{vmatrix}#cursor\end{vmatrix}矩阵和分段函数是高频需求，ali出来的是对齐环境，cases出来的是大括号分段，pma/bma/vma分别是圆括号、方括号、竖线矩阵。敲ali加空格，立刻得到\begin{aligned} \end{aligned}，光标在中间。
上下括号和上下标类：
unb:\underbrace{#cursor}_{#tab}#tab ovb:\overbrace{#cursor}^{#tab}#tab **:^{*} y**:y^{*} x**:x^{*} A**:A^{*} CC:C_{#cursor}^{#tab}#tab AA:A_{#cursor}^{#tab}#tabunb是下括号，ovb是上括号，**直接出上标星号，CC和AA出带上下标的组合符号。注意**这种短码要小心和 Markdown 加粗冲突，Quick Latex 的触发条件是「短码 + 空格」，所以正常打**后跟空格才会触发，写加粗时通常不跟空格，冲突概率低。
根号、分数、极限、积分、求和：
sq:\sqrt{#cursor}#tab sqn:\sqrt[#cursor]{#tab}#tab fr:\frac{#cursor}{#tab}#tab frp:\frac{\partial #cursor}{\partial #tab}#tab frpp:\frac{\partial^{2} #cursor}{\partial #tab^{2}}#tab lim:\lim\limits_{#cursor}#tab limninf:\lim\limits_{n\to\infty} limx0:\lim\limits_{x\to0} int:\int_{#cursor}^{#tab}#tab iint:\iint_{#cursor}^{#tab}#tab sum:\sum\limits_{#cursor}^{#tab}#tab sumn1inf:\sum\limits_{n=1}^{\infty} prodi1n:\prod\limits_{i=1}^{n}fr是最常用的分数，frp和frpp是一阶、二阶偏导，lim带\limits让下标在正下方，int/iint/sum/prod都是带上下限的写法。sumn1inf这类是固定形式，省去填参数。
希腊字母和常用符号：
al:\alpha be:\beta ga:\gamma de:\delta De:\Delta th:\theta la:\lambda mu:\mu pi:\pi si:\sigma om:\omega Om:\Omega pa:\partial inf:\infty to:\to ti:\times cd:\cdot cds:\cdots leq:\leq geq:\geq ne:\ne in:\in ca:\cap cu:\cup这些是单字母短码，敲al加空格出\alpha。注意in这个短码比较危险，因为英文里in太常见，建议改成inn或\in之类，否则你打英文单词in加空格会被替换。这是我踩过的坑之一，短码越短越容易误触发，建议对高频英文词做规避。
导数、范数、矩阵、统计符号：
fxx:f_{x} fxxx:f_{xx} fxxy:f_{xy} llkh:\left|\left|#cursor\right|\right|#tab det:\text{det} tr:\text{tr} var:\text{Var} cov:\text{Cov} argmax:\text{argmax } argmaxd:\mathop{\text{argmax}\space}\limits_{#cursor}#tab mbb:\mathbb{#cursor}#tab bbR:\mathbb{R} bbI:\mathbb{I}fxx系列是偏导简写，llkh是双竖线范数，argmaxd带下标，mbb出黑板体，bbR直接出实数集符号。
括号和修饰符：
jkh:\left(#cursor\right)#tab dkh:\left\{#cursor\right\}#tab |kh:\left|#cursor\right|#tab bar:\bar{#cursor}#tab hat:\hat{#cursor}#tab til:\tilde{#cursor}#tab ovl:\overline{#cursor}#tabjkh是自适应圆括号，dkh是自适应大括号，|kh是绝对值，bar/hat/til/ovl是各种帽子。
3.2 AI 插件 API 配置片段
如果你用 Copilot for Obsidian 或类似插件，配置通常是一个 JSON 或表单。以 OpenAI 兼容格式为例，配置片段如下：
{ "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "model": "你选用的模型ID", "temperature": 0.3 }如果你用的是 Text Generator，配置在插件设置里，字段名可能是API Base URL、API Key、Model，对应填：
API Base URL: https://taotoken.net/api API Key: sk-你的Key Model: 你选用的模型ID如果你用 Claude Code 或 Codex 类工具做公式相关的脚本处理，配置在~/.claude/settings.json或~/.codex/auth.json。以 Codex 的auth.json为例：
{ "OPENAI_API_KEY": "sk-你的Key", "OPENAI_BASE_URL": "https://taotoken.net/api" }Claude Code 的settings.json里对应：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key" } }三件套记牢：Base URL 是https://taotoken.net/api，Key 是sk-开头，Model ID 按你选的模型填。任何一处缺失都会导致请求失败，后面排障会逐个对照。
4. 验证请求与成功结果：从短码到渲染链路
配置完要验证两件事：Quick Latex 短码是否生效，以及 AI 插件能否通过 TaoToken 正常返回。
4.1 验证 Quick Latex 短码
新建一个笔记，输入ali然后按空格。如果配置正确，你会看到ali被替换成：
\begin{aligned} \end{aligned}光标停在\begin{aligned}和\end{aligned}之间。接着输入x &= y \\，再换行输入z &= w，得到：
\begin{aligned} x &= y \\ z &= w \end{aligned}Obsidian 的实时预览会把它渲染成对齐的两行公式。如果没渲染，检查是否用$$包裹，或者是否在行内用$。Quick Latex 只负责生成文本，渲染是 MathJax 的事。
再测一个带#tab的短码，输入fr加空格，得到\frac{}{}，光标在第一个花括号里，输入a，按 Tab，光标跳到第二个花括号，输入b，得到\frac{a}{b}。这就是#cursor和#tab的配合效果。
4.2 验证 TaoToken 请求
用 curl 先确认 Key 和 Base URL 可用：
curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的Key" \ -d '{ "model": "你选用的模型ID", "messages": [ {"role": "user", "content": "把 x 的平方加 y 的平方等于 1 写成 LaTeX"} ] }'成功时返回 JSON，choices[0].message.content里是类似x^2 + y^2 = 1的内容。如果返回 401，是 Key 问题；返回 404，是 Base URL 或路径问题；返回local proxy failed，是插件侧网络配置问题，不是 TaoToken 的问题。
然后在 Obsidian 的 AI 插件里发一条测试消息，比如「把 \frac{a}{b} 解释一下」，看是否正常返回。如果插件报reading choices错误，通常是返回结构不符合插件预期，检查 Model ID 是否拼错，或者该模型是否支持 chat completions 格式。
4.3 完整链路演示
一个典型工作流：在笔记里敲fr加空格生成\frac{}{}，填入内容；遇到不会写的公式，选中自然语言描述，调用 AI 插件生成 LaTeX；把生成的 LaTeX 粘回笔记，用 Quick Latex 的短码继续微调。整条链路里，Quick Latex 管输入效率，TaoToken 管模型调用，Obsidian 管渲染和存储。
验证成功的标志：短码替换即时生效，AI 插件返回内容无报错，公式在预览里正常渲染。三者都通过，说明配置完成。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
这一节按真实报错逐条对照，每条给出原因和修法。
5.1 401 Unauthorized
现象：curl 或插件返回 401。原因通常是 Key 错误、Key 过期、或请求头格式不对。检查三点：Key 是否以sk-开头且完整；请求头是否是Authorization: Bearer sk-xxx，注意Bearer后有空格；Key 是否在 https://taotoken.net/api-keys 里被删除或重置。如果 Key 刚创建，确认没有多余空格或换行。
5.2 local proxy failed
现象：插件报local proxy failed或类似网络错误。原因通常是插件配置了本地代理端口，但该端口没有服务在跑，或者系统代理设置和插件设置冲突。修法：在插件设置里关闭代理选项，或把代理地址清空；确认 Obsidian 能直接访问https://taotoken.net/api。这个报错和 TaoToken 无关，是本地网络配置问题。
5.3 reading choices 报错
现象：插件返回Cannot read properties of undefined (reading 'choices')。原因是返回 JSON 里没有choices字段，通常是 Model ID 填错，或者该模型不支持 chat completions 接口。修法：在 https://taotoken.net/doc 确认模型名，换成明确支持对话的模型；用 curl 单独测一次，看返回结构里有没有choices。
5.4 OAuth 相关报错
现象：插件提示 OAuth 失败或需要登录。原因是某些插件默认走 OAuth 流程，而你用的是 API Key 模式。修法：在插件设置里把认证方式从 OAuth 改成 API Key，填入 TaoToken 的 Key 和 Base URL。如果插件只支持 OAuth，那它不适合接 TaoToken，换一个支持自定义 API 的插件。
5.5 短码不触发
现象：敲ali加空格没反应。检查：Quick Latex 插件是否启用；短码是否在设置里正确保存（注意不要带反引号）；触发键是否是空格（有些版本可改）；短码是否和 Obsidian 其他插件冲突。另外，in、to这类短码容易被英文输入误触发，建议改长一点。
5.6 公式不渲染
现象：短码生成了 LaTeX，但预览里是纯文本。检查：是否用$...$或$$...$$包裹；Obsidian 设置里「编辑器 → 显示行内公式」是否开启；LaTeX 语法是否有误，比如\begin{aligned}没闭合。Quick Latex 不负责渲染，渲染问题去 MathJax 那边找。
6. 持续维护与 CTA：把配置沉淀成可复用资产
这套配置的价值在于可复用。我的做法是把短码表存成一个单独的 Markdown 文件，放在 vault 里，每次调整后同步到 Quick Latex 设置。这样换设备或重装 Obsidian 时，直接复制粘贴就能恢复。AI 插件那边，把 Base URL、Key、Model ID 三件套记在一个加密笔记里，Key 定期轮换。
如果你还没开始，建议顺序是：先装 Quick Latex，把ali、fr、sum、int这几个高频短码配好，用一周形成肌肉记忆；再考虑接 AI 插件，用 TaoToken 的 API 做公式生成和校验。模型对话验证可以去 https://taotoken.net/models 先试；接入文档在 https://taotoken.net/doc ；Key 管理在 https://taotoken.net/api-keys ；账户和用量在 https://taotoken.net/console 。如果你长期用 AI 辅助编码或 Agent 工作流，可以看 https://taotoken.net/coding-plan 。
最后留一个实用技巧：Quick Latex 的短码表可以按主题分组，比如「环境类」「希腊字母类」「导数类」，每组之间空一行，方便查找和增删。每次新增短码后，立刻在测试笔记里敲一遍确认，避免积累一堆没验证的配置。这套笔记我会持续更新，遇到新的报错或好用的短码就补进来。
