What's broken?
A docs page is missing or a link is broken
Where in the spec or docs?
https://modelcontextprotocol.io/specification/2025-11-25/schema.md
What should happen?
I love that you have made a markdown copy/mirror of the specification webpages, however one of the files isn't actually markdown. https://modelcontextprotocol.io/specification/2025-11-25/schema.md is a wild mix of HTML DIV, SPAN, and some markdown tags as well. I suspect you need to fix the parser/converter you are using to generate the .md mirror files.
(the diagnosis from my LLM is that "every type entry is a block of TypeDoc-generated HTML dumped into the .md body", "unclosed divs", and "Pointless backslash escapes inside HTML. \{, \}, \[, \] appear inside SPANs where markdown escaping has no effect — suggests the source is MDX that was blindly piped through a markdown escaper before being served as .md.")
It appears the other files that comprise the markdown version of the spec are fine.
What actually happens?
Nice clean markdown.
Anything else?
No response
What's broken?
A docs page is missing or a link is broken
Where in the spec or docs?
https://modelcontextprotocol.io/specification/2025-11-25/schema.md
What should happen?
I love that you have made a markdown copy/mirror of the specification webpages, however one of the files isn't actually markdown. https://modelcontextprotocol.io/specification/2025-11-25/schema.md is a wild mix of HTML DIV, SPAN, and some markdown tags as well. I suspect you need to fix the parser/converter you are using to generate the .md mirror files.
(the diagnosis from my LLM is that "every type entry is a block of TypeDoc-generated HTML dumped into the .md body", "unclosed divs", and "Pointless backslash escapes inside HTML. \{, \}, \[, \] appear inside SPANs where markdown escaping has no effect — suggests the source is MDX that was blindly piped through a markdown escaper before being served as .md.")
It appears the other files that comprise the markdown version of the spec are fine.
What actually happens?
Nice clean markdown.
Anything else?
No response