Giving a markdown version of a page seems like an interesting choice instead of just embedding a schema marked up one
It gets even more "interesting" for markdown-based systems like Astro or Obsidian Publish: author in md -> ship html && optionally serve md?
Every page on code.claude.com has a markdown version available by just appending ".md", and Claude Code knows about it. E.g:
https://code.claude.com/docs/en/overview and
https://code.claude.com/docs/en/overview.md