Get startedCLIAPIMCPWebDesktopAgentsSupportBillingChangelog
← All changelog
April 28, 2026

Mermaid, KaTeX, and Callouts in doc bodies.

Doc bodies now render Mermaid diagrams (15 types), KaTeX math (inline and block), GitHub-style callouts, collapsible toggles, sanitized SVG, and lone-URL embeds for YouTube, Loom, Figma, and friends.

New
  • Mermaid: ` ```mermaid ` fenced code blocks render as diagrams. 50 per doc, 30 KB source cap each.
  • KaTeX: `$inline$` and `$$block$$` math. 500 per doc, 8 KB cap each.
  • Callouts: `> [!NOTE]`, `> [!TIP]`, `> [!IMPORTANT]`, `> [!WARNING]`, `> [!CAUTION]`. Color-coded with the icon to the left.
  • Toggles: `<details><summary>X</summary>...</details>` collapse and expand inline.
  • Sanitized SVG: ` ```svg ` fenced blocks render after a strict sanitizer pass. 100 KB cap each.
  • Lone-URL embeds: a paragraph that's just a YouTube, Vimeo, Loom, Figma, CodePen, or gist URL renders as the embedded preview.
API
  • MCP `validate_doc_markdown(markdown=...)` returns parsed counts + errors + warnings without writing. Use it before a long doc-write to catch cap violations.