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!