Obsidian 笔记增强工具箱（闪卡 + KaTeX + TikZJax + Mermaid + 高级语法 + CLI + 事实核查）
Overview
本 skill 整合七类 Obsidian 笔记增强能力：
- 闪卡生成：将笔记改写为 Spaced Repetition 插件可识别的闪卡（
#闪卡标签 + 三种闪卡格式）。 - KaTeX 数学公式：用
$...$/$$...$$编写规范的数学公式（Obsidian 原生 MathJax 渲染）。 - TikZJax 绘图：在笔记中用
```tikz代码块绘制精确数学图像、电路图、化学式等（依赖 obsidian-tikzjax 插件）。 - Mermaid 图表：用 Obsidian 原生支持的
```mermaid代码块绘制流程图、时序图等结构化图表。 - 高级语法：使用 Callout 提示块（
> [!tip]）、脚注（^[]/[^]）、双链（[[...]]）、嵌入（![[...]]）等 Obsidian 方言 Markdown。 - obsidian-cli 自动化：用命令行搜索、创建、移动、删除笔记，批量管理仓库。
- 事实核查：修改笔记中的事实性内容（诗句原文、作者年代、公式形式）前用多引擎搜索核实，查无实据只标注不改动。
功能路由
按用户需求选择工作流与参考文档：
| 用户意图 | 工作流 | 必读参考 |
|---|---|---|
| 笔记转闪卡、诗歌挖空、插入 #闪卡 | 闪卡生成工作流 | references/syntax-rules.md（必查）、references/poetry.md（诗歌时） |
| 编写/修正数学公式（希腊字母、分式、矩阵、分段函数、多行对齐） | KaTeX 公式工作流 | references/katex.md |
| 画函数图像、几何图、电路、化学式、交换图 | TikZJax 绘图工作流 | references/tikzjax.md |
| 画流程图、时序图、类图、ER 图、甘特图、思维导图 | Mermaid 绘图工作流 | references/mermaid.md |
| 用 Callout 提示块、脚注、双链、嵌入、高亮、注释等高级语法 | 高级语法工作流 | references/obsidian-syntax.md |
| 搜索/创建/移动/删除笔记、定位 vault | CLI 自动化工作流 | references/obsidian-cli.md |
| 核实笔记中的年代/作者/诗句原文/公式形式 | 事实核查工作流 | references/fact-check.md |
| 不确定用公式还是 TikZ 图 | 纯符号公式用 $$，图像用 TikZ |
两份文档对比阅读 |
| 不确定用 TikZ 还是 Mermaid | 见下方"绘图选型决策表" | 两份文档对比阅读 |
绘图选型决策表（TikZ vs Mermaid）
| 场景 | 选型 | 理由 |
|---|---|---|
| 数学函数图像（精确曲线、坐标轴、渐近线） | TikZ | 可精确控制定义域、采样、标注点 |
| 几何图形、电路图、化学结构式、交换图 | TikZ | Mermaid 不支持这些领域 |
| 流程图、时序图、类图、ER 图、甘特图 | Mermaid | 声明式语法，改结构比重画快得多 |
| 思维导图、时间线、git 分支图 | Mermaid | 原生图表类型直接支持 |
| 需要精确排版/物理坐标的一切图 | TikZ | Mermaid 布局由引擎自动决定 |
原则：结构性关系图用 Mermaid，精确科学与数学图用 TikZ。
闪卡生成工作流
- 读取内容：读取用户指定的笔记文件，或直接处理用户粘贴的文本。
- 插入标签：在文档顶部插入
#闪卡标签。若用户给出分类（如"编程/Python"），使用多级标签#闪卡/编程/Python；未给出时根据笔记内容推断合适的子分类。若文档有 YAML frontmatter，标签插在 frontmatter 之后、正文之前。 - 识别重要信息：找出值得记忆的内容——定义、概念、术语、关键事实、易混点、诗句等，为每条内容选择最合适的闪卡类型。
- 生成闪卡：严格按
references/syntax-rules.md中的语法细则改写。诗歌内容必须按references/poetry.md的专项规范处理。能用完型填空 (==...==) 的场景优先用完型（见references/syntax-rules.md第 5 节选型规则）。 - 拆分复查：扫描所有生成的单行闪卡（
::/:::），若某张卡的答案含多个独立事实，继续拆分为多张卡，或改为完型填空。确认每张卡只考一个知识点后再进入下一步。 - 多空防漏检查：扫描全文中所有同一句内的多个
==挖空==：
- 如果它们语义上属同一组知识（并称、列表、人物属性），必须用同序号==1;;分组（否则多张卡互漏答案）。
- 如果它们是as/sa交替的诗句挖空，确认状态码正确且出处行码数匹配。
- 人物卡的名字/字号/朝代/称号若在同一句，统一加同序号组。 - 文字打磨：逐条检查完型填空的语句是否自然：
- 删除冗余谓语（"的特点是""的地位是"等）。
- 确保遮住挖空后句子仍像正常中文。
- 提示词不要太简略，应有实际联想价值。 - 修复错误：明确的错别字直接修复，并在被修改处末尾加行级脚注
^[原文]（脚注内写修改前的原文），便于用户核对；涉及事实（年代、作者、诗句原文、公式形式）的修改先按事实核查工作流核实，查无实据的保留原文并加^[存疑：...]标注。 - 输出：编辑类任务直接写回原文件；用户粘贴文本则在回复中输出完整改写结果。
闪卡选型决策表
按场景选型，不要凭格式偏好：
| 场景 | 选型 | 示例 |
|---|---|---|
| 定义/性质（答案是句中关键词） | ==完型== |
《春秋》是第一部==编年体==史书。 |
| 别名/称号/字/号 | ==完型== |
李白被称为=="诗仙"==。 |
| 列表（3~6 项） | ==1;;项== 同序号完型 |
四书指==1;;《论语》==、==1;;《孟子》==… |
| 列表（≥7 项） | ? 多行卡或拆组 |
建安七子用 ==1;; 七项同考；唐宋八大家拆唐宋两组 |
| 诗句/成对互问 | ==as;;A== 与 ==sa;;B== 交替 |
诗句前后半句 |
| 人物评价/引文（谁对谁的评价） | :: 保留 |
苏轼对王维的评价::"诗中有画，画中有诗"。 |
| 长答案/多事实 | 拆卡或 ? |
屈原的地位::... → 拆为"爱国诗人"+"浪漫主义奠基人"两张完型 |
| 多属性人物信息 | ==1;; 同序号组，一张卡同考 |
孟子，名==1;;轲==，字==1;;子舆==，战国==1;;邹国==人。 |
核心原则：能用完型的用完型，必须用 :: 的才保留 ::。详细选型规则见 references/syntax-rules.md 第 5 节。
KaTeX 公式工作流
- 确认表达场景：行内提及用
$...$，独立成段/重要公式用$$...$$。 - 按
references/katex.md速查编写：希腊字母、上下标、分式根式、运算符、矩阵、align多行对齐、cases分段函数均有模板与规范。 - 遵守排版规范：变量斜体、多字母函数名与文字用直立体（
\sin、\text{}）；中文必须放\text{}内；上下标多项套{}；\\换行只在\begin...\end环境内生效，$$顶层裸\\无效——多个独立公式拆多个$$块。 - 职责边界：纯公式用
$/$$；需要画"图"（函数图像、几何图）时转 TikZJax 工作流。 - 输出：公式嵌入正文对应位置；成组公式（如公式表）按用户笔记现有排版习惯组织。
TikZJax 绘图工作流
- 确认需求类型：函数图像 / 几何 / 电路 / 化学式 / 交换图，判断需要的宏包。
- 按模板编写
```tikz代码块：必须含\begin{document}…\end{document}；需要宏包时在\begin{document}之前用\usepackage{}加载。 - 对照
references/tikzjax.md：使用其中的函数图像模板（坐标轴、plot 定义域、关键点、渐近线）与避坑清单（三角函数加r、反三角换算、分段绘制间断函数等）。 - 保守使用宏包：只加载插件明确支持的宏包（chemfig、tikz-cd、circuitikz、pgfplots、array、amsmath、amsfonts、amssymb、tikz-3dplot），不支持的宏包会导致渲染失败。
- 输出：将代码块插入用户笔记的合适位置（通常在对应知识点标题下）。
Mermaid 绘图工作流
- 确认图表类型：流程图 / 时序图 / 类图 / 状态图 / ER 图 / 甘特图 / 饼图 / 思维导图 / 时间线 / git 图。
- 按
references/mermaid.md的语法模板编写```mermaid代码块：Obsidian 原生渲染，无需插件。 - 遵守避坑规则：节点文字含括号、特殊符号时加引号；中文可直接使用；先写最小可渲染版本再逐步加复杂度。
- 输出：插入笔记合适位置，并告知用户在阅读视图/实时预览中即可看到渲染结果。
高级语法工作流
- 确认语法类型：Callout / 脚注 / 双链 / 嵌入 / 高亮 / 注释，查
references/obsidian-syntax.md对应小节。 - 按规范编写：Callout 首行
> [!类型]、空行保留>前缀；脚注用^[...]（行内）或[^id]+ 定义行；双链[[笔记]]、嵌入![[...]]（感叹号在前，不要写成[[!...]]）。 - 语义选型：Callout 按语义选类型（技巧用
tip、警告用warning、示例用example），不要只看颜色；需要发布到 GitHub 的笔记只用NOTE/TIP/IMPORTANT/WARNING/CAUTION五种。 - 配合闪卡：
==高亮==是完型填空的基础语法；行内脚注^[...]用于标注对原文的修复，且挖空内]与闭合==之间必须留一个空格（闪卡铁律）。 - 输出：语法嵌入正文对应位置；改名/移动笔记后提醒用
obsidian-cli move维护双链。
obsidian-cli 自动化工作流
- 定位 vault：读 Obsidian 配置文件（Windows:
%APPDATA%\obsidian\obsidian.json；macOS:~/Library/Application Support/obsidian/obsidian.json），或已设默认时用obsidian-cli print-default --path-only。不要猜 vault 路径。 - 按需求选命令：
search/search-content查笔记，create建笔记，move安全移动（自动更新双链），delete删除。 - 内容编辑优先直接改文件：vault 就是普通文件夹，改
.md内容直接用文件工具编辑，Obsidian 会自动感知；只有"移动/重命名需同步更新双链"这类场景才必须用 CLI。 - 详细命令与注意事项见
references/obsidian-cli.md。
事实核查工作流
- 判断是否需要查：明确的错别字（如"按装"→"安装"）直接修，不用查；涉及事实归属、年代、诗句原文、公式形式的疑点必须查。
- 按
references/fact-check.md选引擎搜索：中文内容（古诗词、文史常识）优先国内引擎（百度、Bing 国内版、搜狗微信），英文内容用 Google/DuckDuckGo；至少两个独立来源一致才认定为事实。 - 按结论处理：核实为错误 → 修复并加
^[原文]脚注注明依据；查无实据 → 保留原文并加^[存疑：...]，不擅自改动。
铁律
闪卡
- 一个知识点一张卡：单张闪卡只聚焦一个可独立提问的知识点。若答案含多个独立事实（如人物的字、朝代、称号），必须拆为多张卡或用完型填空。
- 列表类知识直接问答："包括哪些/是什么"类列表知识用
::直接问答（如前四史:::...），禁止做成多点挖空逐项遮（避免"多问少"——4 项列表生成 4 张卡、每张只考 1 项还互相剧透）。 - 题目必须完整：
::的问题侧不能只写裸人名/书名，必须让复习者明确知道要答什么。反面：萧何::典故"成也萧何，败也萧何"（看到"萧何"不知答朝代还是典故）；正面：与萧何相关的典故::"成也萧何，败也萧何"。人物类按"姓名/字号/朝代/称号/作品/评价"拆卡时，问题侧写明属性（如司马迁的字与朝代::字子长，西汉人）。 - 不动学习记录：闪卡下方的
<!--SR:!2026-07-29,0,230-->注释是 Spaced Repetition 插件的学习记录，禁止修改、移动或重排；删除某张闪卡（含改写题目导致旧卡失效）时，必须将其对应的学习记录一并删除。 - 名句默写用完型填空：名句/名诗默写类内容统一用完型填空（
as/sa交替），出处行格式与诗歌相同（-==aa;;《出处》==）。 - 完型填空使用状态码时，同一组内每个挖空的状态码个数必须一致，状态码个数 = 该组生成的闪卡数。
- 诗歌出处行统一使用全
a状态码，个数与该诗歌块生成的闪卡数一致（如正文用as两个码则出处用aa；整组 4 张卡则用aaaa），格式为-==aa;;《出处》==。 - 完型填空之间必须空行：
==...==格式在 Obsidian Spaced Repetition 插件中属于多行卡（非::/:::即多行），每张完型卡前后必须有空行隔开。连续的完型行会被插件误当成一张卡，导致解析错乱。 - 脚注必须在挖空内：
==答案^[注] ==，脚注写在外面（==答案==^[注]）会让复习时直接看到注释，泄露答案。]和闭合==之间留一个空格。 - 提示不得互相引用：同组多个挖空的提示词不能引用另一个挖空的内容（如
==1;;《子虚赋》;;与《上林赋》并称==直接泄露另一个空）。提示只写该空自身特征。 - 相邻
==加分隔但保分组：=="A"=="B"==→==1;;A==、==1;;B==。只加、去掉序号会把一张卡拆成多张互漏卡。 - 超大单卡拆为
?多行：一条::卡需要背三项以上独立内容（如李广的三句诗、五个典故），改用?多行卡分条列出，降低单次记忆负担。 - 诗歌挖空中若含行级脚注，脚注
]与闭合高亮==之间必须保留一个空格（==as;;内容^[注释] ==），避免语法错乱。 - 不随意删减原文信息；只重构为闪卡格式并修复明确错误。
- 修复事实性内容前必须先核实（见
references/fact-check.md）；查无实据不改动，只标注^[存疑：...]。 - 闪卡内容不限于文字：笔记能渲染的内容闪卡都能显示（图片
![[...]]、公式、代码块、列表等均可放入问题/答案）；表格部分受限——不能把整张表塞进?多行闪卡的答案区（表格前的空行会被插件视为闪卡结束），但表格内可以做挖空：整张表作为一个闪卡单位，挖空按完型填空规则成卡提问；把表格当作?卡的答案则须配置闪卡结束标志，但该设置开启后所有无结束标志的闪卡会错乱，谨慎对待（详见references/syntax-rules.md第 4 节）。
绘图
- 不破坏已有图代码：用户笔记中已有的 tikz/mermaid 代码块，除非用户要求或代码确有错误，否则原样保留。
- tikz 代码块必须完整：
\begin{document}/\end{document}缺一不可；宏包声明必须在其之前。 - 先能渲染，再求美观：先给最小可工作的图，确认结构正确后再加标注、颜色、网格。
- 数学公式内容优先用 Obsidian 原生
$$...$$（MathJax），不要用 TikZ 画纯公式——TikZ 只用于"图"；公式语法规范见references/katex.md。
CLI 与文件操作
- vault 是普通文件夹，但
.obsidian/配置目录不要用脚本改动。 - 移动/重命名笔记必须用
obsidian-cli move（同步更新全库双链），禁止用系统mv。 - 批量操作前先确认 vault 路径，避免写错仓库。
References
references/syntax-rules.md—— Spaced Repetition 三种闪卡格式的完整语法细则、序号/状态码成卡规则、常见错误references/poetry.md—— 诗歌/古诗词整理专项规范（挖空、注释、出处行）references/examples.md—— 编程/文学/诗歌笔记的完整改写前后对照示例references/katex.md—— KaTeX/LaTeX 数学公式速查：希腊字母、上下标、直立体规范、分式根式、运算符、矩阵、align/cases 环境、Obsidian 避坑清单、公式类闪卡写法references/obsidian-syntax.md—— Obsidian 方言 Markdown：Callout 全类型/别名/折叠/嵌套、行内脚注与标准脚注、双链与嵌入（含图片尺寸/PDF 页码）、高亮/注释/块 ID、GitHub 兼容性说明references/tikzjax.md—— obsidian-tikzjax 插件用法：tikz 代码块结构、支持的宏包、函数图像绘制模板（坐标轴/定义域/渐近线/关键点）、常见渲染失败原因references/mermaid.md—— Obsidian 原生 Mermaid 支持：十种图表类型语法模板、节点与连线写法、特殊字符避坑、与 TikZ 的选型对比references/obsidian-cli.md—— obsidian-cli 命令速查：vault 定位（含 Windows/macOS 配置路径）、搜索/创建/移动/删除、直接编辑 vs CLI 的决策原则references/fact-check.md—— 笔记事实核查：何时需要核实、中英文搜索引擎与运算符速查、核查纪律（双源一致、存疑标注）
