前言¶
在 Obsidian 里写笔记的人常遇到两类重复劳动:一是把笔记内容转成可复习的闪卡、给古诗词做挖空,需要自己记一套语法;二是写数学公式、TikZ 图、Mermaid 图表、Callout 提示块时,格式容易写错,改笔记里的事实性内容时又怕写错诗句或公式。下面介绍的 obsidian-ljded 把这七类操作收敛成一个 Skill,让模型直接按约定语法产出可用的笔记内容。
这是什么¶
obsidian-ljded 是一个面向 Obsidian / Markdown 笔记的增强工具箱,覆盖七类能力:Spaced Repetition 闪卡生成、KaTeX/LaTeX 数学公式、TikZJax 数学绘图、Mermaid 图表、Callout/脚注/双链/嵌入等高级语法、obsidian-cli 仓库自动化、笔记事实核查。
发布者为 user_6c2368ba,来源 community,分类 knowledge-management,当前版本 1.0.6,无需 API Key。在 SkillHub 页面上的评分为 100000,下载 846 次,安装 0。
它解决的是「同一个笔记体系里既有复习卡、又有公式、又有图、又有引用关系」时的格式一致性问题:模型按统一的语法约定输出,用户不必在多个插件文档之间来回查。
核心功能¶
1、Spaced Repetition 闪卡。支持单行闪卡(:: / :::)、多行闪卡(? / ??)、完型填空挖空(==内容==),可把 Markdown 笔记转成闪卡,也可整理诗歌/古诗词为挖空闪卡,并插入 #闪卡 标签。
2、KaTeX / LaTeX 数学公式。覆盖行内 \(...\) 与块级 $\(...\)$,包含希腊字母、矩阵、分段函数、多行公式等常见形式。
3、TikZJax 数学绘图。通过 tikz 代码块输出函数图像、TikZ 图、电路图、化学结构式、交换图,依赖 TikZJax 插件渲染。
4、Mermaid 图表。流程图、时序图、类图、甘特图、思维导图等。
5、Obsidian 高级语法。Callout 提示块(>[!note] / [!tip] / [!warning])、行内脚注 ^[]、标准脚注 [^]、双链 [[笔记]]、嵌入 ![[…]]、高亮 ==、注释 %%。
6、obsidian-cli 仓库自动化。搜索、创建、移动、删除笔记,定位 vault,批量管理仓库。
7、笔记事实核查。在修改诗句原文、作者年代、公式形式这类事实性内容之前,先核实真伪。
安装与启用¶
官方地址:https://api.skillhub.cn/user_6c2368ba/obsidian-ljded
SkillHub 页面:https://www.skillhub.cn/skills/user_6c2368ba/obsidian-ljded
该 Skill 基于通用 SKILL.md 格式,标签 requires_api_key=false,即启用时不需要 API Key。已抓取资料中没有给出官方安装命令、目录或配置文件路径,也没有分宿主(Cursor / Codex CLI / Claude Code)的差异说明,因此这里不给出命令。启用方式以官方页面为准,安装前建议在页面上确认当前版本的安装说明。
典型用法¶
以下示例是 Obsidian / Markdown 语法层面的写法,Skill 的作用是让模型在你提出需求时按这套语法产出内容。
闪卡。把一句诗整理成挖空闪卡:
==春风==又绿江南岸,明月何时照我还。
单行闪卡用 :: 与 ::: 分隔问题与答案,多行闪卡用 ? 与 ??。
数学公式。行内公式:
由 $E = mc^2$ 可得……
块级公式:
$$
f(x) = \begin{cases} x^2, & x \ge 0 \\ -x, & x < 0 \end{cases}
$$
Callout 提示块:
> [!warning] 注意
> 修改诗句原文前先做事实核查。
脚注与双链:
正文^[这是行内脚注]。
参见 [[另一篇笔记]],或嵌入 ![[...]]。
TikZ 与 Mermaid 分别放进 tikz 代码块和 mermaid 代码块,渲染依赖 Obsidian 侧已安装的 TikZJax 等插件。
适用场景与注意¶
适合长期用 Obsidian 写学习笔记、技术笔记,且需要把笔记直接转成复习材料的人;也适合在笔记里大量使用公式、图和双链,希望模型产出格式统一的场景。
三点需要注意。第一,TikZJax、Mermaid 的实际渲染取决于 Obsidian 侧插件,Skill 只负责产出代码,不负责渲染。第二,obsidian-cli 相关的搜索、移动、删除是仓库级操作,其中删除和批量移动不可逆,执行前应确认目标 vault 与路径。第三,事实核查能力是流程上的约束,不是保证;涉及诗句原文、作者年代、公式形式时,仍应以权威来源复核后再写入。
结尾¶
obsidian-ljded 的价值在于把 Obsidian 里分散的七类语法操作打包成一套约定,减少查文档和试错的成本。官方地址:https://api.skillhub.cn/user_6c2368ba/obsidian-ljded