A ```mermaid fence came out of the build as syntax-highlighted CSS. highlight.js has no mermaid grammar, so the fence fell through to auto-detection, which took graph TD; A-->B; for selectors and wrapped the diagram source in hljs-selector-tag spans. Mermaid could still read it — textContent drops the spans — but only if you told it to look at code.language-mermaid, and the page flashed the wrongly-coloured source first.
Added
- A
mermaidfence compiles to<pre class="mermaid">, with no<code>element and the diagram source escaped inside. That is the markup mermaid documents and the default itsrun()selects on, so loading mermaid on the page is all it takes. The fence info string keeps working:```mermaid wide tab=depsstill becomesclass="mermaid wide" data-tab="deps".
Changed
-
book-of-spells1.5 → 2.5,poops-docs-theme4.2 → 4.5. The one that shows:removeAccentsin book-of-spells now folds letters whose mark is written through the glyph —Đ Ł Ø Ħ Þ ßand friends — whichslugifyinherits, andslugifyis what Poops builds heading anchors, collection slugs and permalinks from.Đorđe Balaševićused to slug toore-balasevicbecause the unfolded letter was deleted outright; it isdorde-balasevicnow. A site with those letters in a heading or a title will move the URLs they generate — worth a redirect if anything links to the old ones. -
mermaidis never syntax-highlighted, through fences, the{% highlight %}tag and thehighlightfilter alike. Only the language name is special — a JavaScript fence that mentions mermaid is still highlighted as JavaScript.
Poops ships no mermaid and injects no script, so a page with no diagram carries no library, and a diagram on a page that never loads one shows its source as readable text. The trade against the code-fence story is real and stated in the README: highlighting happens at build time to avoid layout shift, and a browser-rendered diagram pops in after paint.
Full Changelog: v2.5.0...v3.0.0