Obsidian Markdown Structure

Validate and enforce markdown document structure including frontmatter positioning, heading hierarchy, and content organization. Use when creating or validating markdown files.

52 stars 10 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jykim/claude-obsidian-skills --skill obsidian-markdown-structure
Manual install
git clone --depth 1 https://github.com/jykim/claude-obsidian-skills.git /tmp/claude-obsidian-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-obsidian-skills/obsidian-markdown-structure ~/.claude/skills/obsidian-markdown-structure

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Markdown Structure Validation

Enforce consistent markdown structure across all vault content.

## When to Use This Skill

Activate when you need to:
- Create new markdown documents
- Validate document structure
- Fix structural issues
- Ensure consistent formatting

## Core Structure Rules

### 1. Frontmatter Positioning

**Single YAML block at top, blank line after**:
```markdown
✅ 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)
```

**Critical Rules**:
- One YAML block only
- Must be first thing in file
- Blank line after closing `---`
- No content before first heading

> **Note**: This skill validates frontmatter **POSITION** (where it goes in the document).
> For frontmatter **CONTENT** (properties, values, formatting), use `obsidian-yaml-frontmatter` skill.

### 2. Heading Hierarchy

**Start with H2, no H1 duplication**:
```markdown
✅ CORRECT:
---
title: Document Title
---

## Introduction
Content...

### Subsection
Content...

❌ INCORRECT:
# Document Title (duplicates frontmatter title)

## Section
```

**Hierarchy Rules**:
- Use H2 (`##`) for main sections
- Use H3 (`###`) for subsections
- Use H4 (`####`) sparingly
- Don't skip levels (H2 → H4)

### 3. Content Organization

**Summary-first structure**:
Read the full skill on GitHub

Details

Skill name
obsidian-markdown-structure
Path
obsidian-markdown-structure/SKILL.md
License
MIT
Repo updated
23 September 2026

FAQ

What does the Obsidian Markdown Structure skill do?

Validate and enforce markdown document structure including frontmatter positioning, heading hierarchy, and content organization. Use when creating or validating markdown files.

How do I install the Obsidian Markdown Structure skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jykim/claude-obsidian-skills --skill obsidian-markdown-structure. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Obsidian Markdown Structure popular?

It lives in jykim/claude-obsidian-skills, which has 52 GitHub stars and 10 forks.

Related skills

Ai4pkm Helper

52

jykim/claude-obsidian-skills

AI4PKM helper for orchestrator configuration, worker management, and CLI workflow integration.

Productivity & Notes10

Create Vlog Script

52

jykim/claude-obsidian-skills

Create narration-first personal vlog scripts and slide-based recording guides from rough spoken notes and a supplied media folder. Use for reflective video essays, travel or event vlogs, and video-editing briefs; do not use for producing the final edited video unless requested.

Images, Video & Audio10

Interactive Writing Assistant

52

jykim/claude-obsidian-skills

This skill provides comprehensive support for the writing process from ideation through revision. Use this skill when helping users write essays, articles, or creative pieces through interactive collaboration. The skill supports co-evolving outline and prose, voice-based input processing, multiple writing styles, and connection to the user's PKM system for enriched content.

Writing & Content10

Obsidian Mermaid

52

jykim/claude-obsidian-skills

Create Obsidian-compatible Mermaid diagrams. Prefer square layouts (TB + subgraph LR), avoid markdown in labels. Use when creating flowcharts, sequence diagrams, or any Mermaid diagrams in markdown files.

Productivity & Notes10

Obsidian Links

52

jykim/claude-obsidian-skills

Format and validate Obsidian wiki links with proper filename, section, and folder conventions. Verify links exist before creation and fix broken links. Use when creating or checking wiki links in markdown files.

Productivity & Notes10

Obsidian YAML Frontmatter

52

jykim/claude-obsidian-skills

Manage YAML frontmatter properties with consistent formatting, property names, and value types. Use when creating or updating frontmatter in markdown files.

Productivity & Notes10

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.