You wrote your docs in Markdown with Mermaid diagrams because they’re version-controlled and easy to edit. Then someone asked for a Word file, and your flowcharts turned into raw syntax. Pandoc handles most Markdown-to-docx conversion fine, but it treats Mermaid blocks as plain text.