mdshape is a schema-first library that turns any Markdown file into typed JSON with a single function call. Instead of writing regex, chaining remark plugins, or walking ASTs manually, you define a schema — headings, sections, fields, tables, code blocks — and mdshape parses and validates everything for you. Errors come back with line numbers, paths, and codes. 27 typed builders for tables, Mermaid diagrams, LaTeX math, images, links, and more. Full TypeScript inference from schema to json.