obsidian-vault-exporter

Obsidian Vault 导出器

概述

此技能旨在指导 Research Agent 将所有研究成果文档（文献笔记、论文对比矩阵、研究综合、假设和期刊推荐）转换为可交互的笔记，以便直接加入 Obsidian Vault（第二大脑）。Agent 会自动编写结构化的 YAML Frontmatter，添加双向 WikiLinks（[[Note Name]]），标记自定义标签，并提供 Dataview Query 脚本，以构建内容丰富且易于搜索的研究 知识图谱。

依赖项

• extract-methodology
• paper-matrix-builder
• synthesize-research

快速开始

使用示例： "将这份文献综述和论文矩阵的全部结果整理为完整的 Obsidian Vault 结构，包含 Frontmatter、论文之间的 WikiLinks 和 Dataview 查询。"

工作流

1. 检测文件与 Vault 结构

• 识别正在处理的研究文档类型（例如：文献笔记、综合笔记、研究空白分析或完整工作流导出）。
• 如果用户尚未指定，则确定标准 Obsidian 文件夹层级，例如：
  • Vault/Literature/（用于单篇论文笔记）
  • Vault/Gaps & Hypotheses/（用于研究空白和假设）
  • Vault/Synthesis/（用于综合和对比矩阵）
  • Vault/Manuscript/（用于主要手稿草稿）

2. 编写结构化 YAML Frontmatter

• 在每个 Markdown 文件的最上方创建 YAML Frontmatter 条目：

  ---
  title: "Judul Catatan / Paper"
  aliases: ["Alias 1", "Shorthand"]
  tags:
    - research/literature
    - status/processed
    - quartile/q1
  authors: ["Author 1", "Author 2"]
  year: 2026
  doi: "10.xxxx/xxxxx"
  quartile: "Q1"
  sinta_rank: "S1"
  created: 2026-07-15
  ---
  

3. 将文本链接转换为双向 WikiLinks

• 将普通文本引用转换为 Obsidian 双向 WikiLinks：
  • 论文引用：[Smith et al., 2025] $\rightarrow$ [[Literature Note - Smith 2025]]
  • 研究空白引用：Research Gap 1 $\rightarrow$ [[Gap - Low Resource Paraphrasing]]
  • 方法引用：Transformer Model $\rightarrow$ [[Method - Transformer Architecture]]

4. 编写 Dataview 查询与可视化图表

• 在索引／摘要笔记中加入可直接使用的 Dataview 代码块：

  TABLE authors, year, quartile, doi
  FROM "Literature"
  WHERE quartile = "Q1"
  SORT year DESC
  

• 确保所有概念框架图均使用 Obsidian 原生支持的 Mermaid 语法编写。

5. 审查凭据安全并验证输出文件

• 确保 Frontmatter 或笔记内容中未暴露 API 令牌、私密凭据或工作区之外的敏感本地路径。
• 提供导出的 Markdown 文档，以便用户直接复制粘贴或保存到自己的 Obsidian Vault。

常见错误与关键规则

• WikiLinks 语法错误：在 WikiLink 名称中使用多余空格或非法字符（例如 [[ Literature Note ]] 或 [[File/Path:Invalid]]）。
• YAML Frontmatter 无效：忘记用 --- 关闭 YAML 块，或使用违反 YAML 规范的缩进语法。
• 敏感路径泄露：公开写出包含凭据或本地用户名的系统绝对路径。
• 专有 Markdown 格式：使用不受支持或会破坏 Obsidian 原生 Markdown 渲染效果的复杂 HTML 标签。