obsidian-markdown-structure

Validate Markdown structure with frontmatter, heading hierarchy, and quote formatting.

31|15|Updated Sep 5, 2025

Search Tags:#markdown #validation #obsidian #structure #frontmatter #headings

Ready to run

npx skills add https://github.com/jykim/AI4PKM --skill obsidian-markdown-structure

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: obsidian-markdown-structure
Source: https://github.com/jykim/AI4PKM/tree/main/ai4pkm_vault/_Settings_/Skills/obsidian-markdown-structure
Command: npx skills add https://github.com/jykim/AI4PKM --skill obsidian-markdown-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enforces consistent markdown structure across vault content, ensuring proper frontmatter positioning, heading hierarchy, and logical organization to improve reliability and readability.

Core Features & Use Cases

Frontmatter positioning checks: enforce single top YAML block and a blank line after it.
Heading hierarchy enforcement: require H2 as main sections, H3 for subsections, and no skipped levels.
Content organization validation: ensure a summary/overview first and logical section order.
Quote formatting rules: ensure blockquotes are properly formatted for attribution.

Quick Start

Validate a new vault note against the standard structure, ensuring frontmatter at the top and proper heading hierarchy.

Frequently Asked Questions about obsidian-markdown-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I validate markdown document structure in Obsidian?▼

Validate markdown structure by checking frontmatter positioning at the top, heading hierarchy starting with H2 for main sections and H3 for subsections, and ensuring a summary appears first. The Skill enforces these standards automatically across vault notes.

What are the markdown structure requirements for frontmatter and headings?▼

Frontmatter must be a single YAML block at the document top followed by a blank line. Use H2 for main sections, H3 for subsections, and avoid skipped heading levels to maintain proper hierarchy throughout your markdown files.

Can I automatically enforce consistent markdown formatting across my Obsidian vault?▼

Yes, this Skill enforces consistent structure across vault content by validating frontmatter positioning, heading hierarchy, content organization order, and blockquote formatting, ensuring reliability and readability vault-wide.

How should I organize content within markdown documents?▼

Place a summary or overview section first, then organize remaining content into H2 and H3 sections in logical order. This structure improves document readability and ensures consistent organization across your vault.

What happens if my markdown doesn't follow the standard structure?▼

The Skill identifies structure violations such as missing frontmatter, improper heading levels, skipped heading hierarchy, misplaced summaries, and incorrectly formatted blockquotes, allowing you to repair and standardize the document.