obsidian-markdown-structure

The obsidian-markdown-structure skill provides an automated framework for maintaining high-quality, consistent markdown files within an Obsidian vault or general knowledge management system. Designed for writers, researchers, and PKM enthusiasts, this tool ensures that every document adheres to a standardized structural template, making files easier to navigate, search, and process programmatically. By enforcing specific placement of metadata and hierarchy of headers, it prevents common structural drift that occurs in large knowledge bases.

• Automatically verifies the presence and placement of YAML frontmatter at the very top of the file, ensuring a blank line follows for clean parsing.

• Enforces a strict heading hierarchy (starting with H2) to maintain proper document flow and prevent duplication of titles already present in metadata.

• Validates that content follows a logical organizational flow, such as requiring a summary-first structure before diving into detailed sections.

• Ensures proper formatting of quote blocks with attribution, enhancing readability and reference integrity.

• Provides a robust checklist for structural consistency, including checks for skipped heading levels and illegal content placement before the primary header.

• Intended for use when creating new notes from templates, validating existing markdown files for structure compliance, or fixing formatting errors during bulk cleanup.

• Works seamlessly with other PKM skills like obsidian-yaml-frontmatter and obsidian-links to maintain a professional, clean vault ecosystem.

• Input requirements consist of standard markdown files; the tool performs character-level structural analysis to confirm placement and organization rules.

• Note that this skill specifically handles document topology; it does not validate the content values within the frontmatter, which should be managed by dedicated YAML-focused tools.

• Ideal for power users who leverage AI agents for automated vault grooming and quality control.