I built mdschema, a small Go CLI that validates Markdown documents against a YAML “schema.” (required headings/section order, required code blocks by language, table headers, frontmatter rules, links, etc.).

Motivation: Docs are often edited by many people and AI tools, leading to structure drift (missing sections, reordered blocks). This is meant as a simple guardrail you can run locally or in CI.

Feel free to try it out and let me know what you think!