Obsidian Markdown Structure
Validate and enforce markdown document structure including frontmatter positioning, heading hierarchy, and content organization. Use when creating or validating markdown files.
Install
npx skills add jykim/claude-obsidian-skills --skill obsidian-markdown-structuregit 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-structurePersonal 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**:
Details
- Skill name
obsidian-markdown-structure- Repository
- jykim/claude-obsidian-skills
- 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
52jykim/claude-obsidian-skills
AI4PKM helper for orchestrator configuration, worker management, and CLI workflow integration.
Create Vlog Script
52jykim/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.
Interactive Writing Assistant
52jykim/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.
Obsidian Mermaid
52jykim/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.
Obsidian Links
52jykim/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.
Obsidian YAML Frontmatter
52jykim/claude-obsidian-skills
Manage YAML frontmatter properties with consistent formatting, property names, and value types. Use when creating or updating frontmatter in markdown files.
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.