vault

odysseus0 的头像作者 odysseus0

Markdown知识库格式规范。用于撰写笔记或遇到格式/语法问题时使用。涵盖双读者原则(人类+AI)、YAML前置信息、维基链接和来源。

📖 中文导读:Markdown知识库格式规范。用于撰写笔记或遇到格式/语法问题时使用。涵盖双读者原则(人类+AI)、YAML前置信息、维基链接和来源。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: vault description: Format conventions for markdown knowledge vaults. Use when writing notes or when format/syntax questions arise. Covers the dual-reader principle (human + AI), YAML frontmatter, wikilinks, and sources.

Vault Format

Dual-Reader Principle

Notes are read by both humans (via Obsidian/editors) and AI (raw markdown). Write so both have a good experience.

Avoid:

  • Dataview blocks (AI sees dead code)
  • Content that depends on embeds ![[]] resolving
  • Heavy callout syntax

Use freely:

  • Wikilinks [[Note Title]] (both can follow)
  • YAML frontmatter (both can parse)
  • Standard markdown

Note Structure

---
tags:
  - tag1
  - tag2
---

# Title

Content here.

## Sources
- (Author, Year) for claims

Conventions

Frontmatter: YAML with 3-7 specific tags

Links: Inline wikilinks [[Note Title]] or [[Note Title|display text]]

  • No separate "Related Notes" section - links belong in context

Sources: Inline attribution (Author, Year), full references in ## Sources section