用途:把研究笔记、文档、图表和分析结果输出为 Obsidian vault 中的 Markdown 笔记。Obsidian 使用文件夹式 vault 与纯 Markdown 文件,发布即把 .md 写入正确目录。
主要能力:接收按请求传入的 vault 路径并校验其存在且为目录;在指定子文件夹(可嵌套)中创建笔记;文件名做非法字符替换清理;可选写入 YAML frontmatter;支持基本笔记、带 frontmatter 笔记、含 Mermaid 图表笔记、内部链接等格式。Obsidian 原生渲染 Mermaid,图表语法可复用 mermaid-expert 后直接嵌入。还支持 callouts([!note]、[!warning]、[!tip])、标签(#tag 或 frontmatter tags)、内部链接([[Note Name]]、[[folder/Note Name]]、[[Note Name|Display Text]]、[[Note Name#Heading]])与嵌入(![[...]])。
使用方式:分三步——校验 vault 路径,创建笔记(给定 vault_path、folder、filename、content、frontmatter),格式化内容(构建 frontmatter 并清理文件名)。可按类型、日期或项目组织目录结构。发布前检查:vault 路径有效、文件名已清理、目录结构已创建、frontmatter 为合法 YAML、Mermaid 语法正确、内部链接指向已有笔记(如适用)。
适用场景:将研究笔记、会议记录、文档、架构图输出到知识库;按 vault 结构导出分析结果。
限制:发布仅是写文件,不涉及同步、渲染或平台端处理;vault 路径需按请求传入且必须已存在;frontmatter 需为合法 YAML;文档中的安装命令、依赖与具体集成步骤暂未提供。