obsidian-markdown-structure

Markdown 構造の検証

すべての Vault コンテンツで一貫した Markdown 構造を徹底します。

このスキルを使用するタイミング

次の作業が必要なときに有効にします。

• 新しい Markdown ドキュメントを作成する
• ドキュメントの構造を検証する
• 構造上の問題を修正する
• 一貫した書式を確保する

構造の基本ルール

1. フロントマターの配置

ファイルの先頭に YAML ブロックを 1 つだけ配置し、その後に空行を入れます：

✅ CORRECT:
---
title: Document Title
created: 2025-10-31
tags:
  - tag1
---

## First Section Header
Content starts here...

❌ INCORRECT:
---
title: Document Title
---
## First Section (no blank line)

❌ INCORRECT:
## Title

---
frontmatter: here
---
(frontmatter not at top)

重要なルール：

• YAML ブロックは 1 つだけにします
• ファイル内の最初の内容にします
• 閉じる --- の後に空行を入れます
• 最初の見出しより前に内容を置きません

注：このスキルはフロントマターの位置（ドキュメント内の配置場所）を検証します。 フロントマターの内容（プロパティ、値、書式）については、obsidian-yaml-frontmatter スキルを使用してください。

2. 見出しの階層

H2 から始め、H1 と重複させません：

✅ CORRECT:
---
title: Document Title
---

## Introduction
Content...

### Subsection
Content...

❌ INCORRECT:
# Document Title (duplicates frontmatter title)

## Section

階層のルール：

• メインセクションには H2（##）を使用します
• サブセクションには H3（###）を使用します
• H4（####）は必要な場合に限り使用します
• レベルを飛ばしません（H2 → H4）

3. コンテンツの構成

要約を先に置く構成：

✅ CORRECT:
---
frontmatter
---

## Summary
Overview of key points...

## Main Content
Detailed content...

## Related Topics
Links and connections...

❌ INCORRECT:
---
frontmatter
---

This is content without a heading.

## First Section

4. 引用ブロックの書式

出典を付記した引用ブロック：

✅ CORRECT:
> "Quote text here" - Speaker/Context

> "Knowledge is power, but enthusiasm pulls the switch."
> - Ivern Ball

❌ INCORRECT:
"Quote text" (not in blockquote)
> Quote without attribution

構造検証のワークフロー

ステップ 1：フロントマターを確認する

Verify:
- [ ] Single YAML block at top
- [ ] Blank line after closing ---
- [ ] All required properties present
- [ ] Consistent property names

ステップ 2：見出しの階層を確認する

Verify:
- [ ] No H1 after frontmatter (except special cases)
- [ ] Main sections use H2
- [ ] Subsections use H3
- [ ] No skipped levels
- [ ] Logical organization

ステップ 3：コンテンツの構成を確認する

Verify:
- [ ] No content before first heading
- [ ] Summary/overview section first
- [ ] Sections follow logical order
- [ ] Proper quote formatting

ステップ 4：コンテンツの種類に応じて確認する

Check content follows appropriate template structure:
- [ ] Journal: H1 title, standard sections
- [ ] Roundup: Opening quote(s), structured headers
- [ ] Events: Executive Summary, Key Takeaways, Next Actions
- [ ] Clippings: Summary first, then detailed sections

品質チェックリスト

構造の検証を完了する前に、次の項目を確認します。

• YAML フロントマターがファイルの先頭に 1 つだけある
• フロントマターの後に空行がある
• 最初の見出しより前に内容がない
• 見出しの階層が正しい（H2 → H3 → H4）
• 引用ブロックが適切に書式設定されている
• 要約／概要セクションがある
• セクションが論理的な順序に並んでいる
• コンテンツの種類に応じたテンプレート構造に従っている