Markdown Preflight

Research / Rules / SUB-MERMAID-01

SUB-MERMAID-01

Mermaid stays as source code; no diagram renders. This applies to Substack, where the result is degraded.

Affects Substack. Matches mermaid. Fixture markdown-portability-test-v1.

What happens, per destination

Every destination that applies SUB-MERMAID-01, with the live test behind it.
DestinationTested surfaceResultSeverityConfidenceLast tested
SubstackSubstack web post editorDegradedReviewVerifiedTested 2026-08-24.

Why, and what to do

The source survived as a code block but did not render as a diagram.

Do this: Export the diagram as an image and keep a text summary.

Limits of this rule

Related