前言¶
在 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