Parse markdown files into structured representations.
Handles frontmatter extraction, H1/H2 detection, code fence tracking, and numbered heading normalization.