SuperAPI AI 工具集

obsidian-markdown-mastery

写作与研究

查看项目

更新于 10-16 08:00

技能介绍

用途:obsidian-markdown-mastery 是 Obsidian 集成插件下的核心 Markdown 语法技能,负责 Obsidian 专有 Markdown 的精确格式化、提取与校验,为图谱遍历、JSON Canvas 等上层智能体提供底层字符串处理,避免破坏 .md 库。

主要能力:解析并强制以下语法——标准链接 [[Note Name]]、标题链接 [[Note Name#Heading Name]]、块链接 [[Note Name#^block-id]]、别名链接 [[Note Name|Display Text]];嵌入 ![[Note Name]](解析器会将其与语义链接区分归类);Callout 语法 > [!type] Title 加内容块,支持 info、warning、error、success、note 类型。

使用方式:需 Python 3.8+,仅用标准库,无外部依赖。安装依赖命令:pip-compile ./requirements.in 与 pip install -r ./requirements.txt。可用命令:python ./parser.py analyze --file <path_to_md> 提取链接、嵌入、块等元数据;python ./parser.py callout --type <type> --title <title> --text <content> 将目标文本块包裹为 Callout。

架构约束:所有库数据操作必须通过确定性 Python 脚本完成,而非智能体提示式正则;该技能定义 obsidian-parser 模块执行这些确定性操作。模块不感知项目特定协议、持久层或外部服务,仅负责将文本解析为有效的 Obsidian 链接与块引用。

配置:项目特定配置(库路径、注入点)通过环境变量 OBSIDIAN_VAULT_PATH 管理,protocol-manager、chronicle-manager 等工具依赖该变量定位 Obsidian 库根目录;若缺失则默认使用项目根目录。

限制:资料未提供收费、价格、平台支持范围及具体效果数据;requirements.txt 当前为空,仅标准库。