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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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/apiAPI Key 填你在控制台创建的 KeyModel 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_{n1}^{\infty} prodi1n:\prod\limits_{i1}^{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/apiKey 是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} ] }成功时返回 JSONchoices[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 的短码表可以按主题分组比如「环境类」「希腊字母类」「导数类」每组之间空一行方便查找和增删。每次新增短码后立刻在测试笔记里敲一遍确认避免积累一堆没验证的配置。这套笔记我会持续更新遇到新的报错或好用的短码就补进来。