Fix Markdown block rendering in Text

[esconner]

Fixes #874

This changes Text(markdown:) and Text(markup:parser:) to preserve block Markdown structure instead of doing fragile HTML string
splitting.

What changed:

• stop stripping the first heading from Text Markdown bodies
• detect the true single-paragraph case from parsed HTML
• render block Markdown inside a container so headings/lists/paragraphs remain valid
• escape plain text and inline/code block contents in MarkdownToHTML so the renderer always produces valid HTML

Tests:

• preserve multiple headings in Text(markdown:)
• avoid invalid paragraph output for mixed block Markdown
• preserve block structure for headings + lists
• cover the same behavior through Text(markup:parser:)
• verify Markdown text/code escaping in MarkdownToHTML

Validation:

• validated in a separate Ignite-based project against real integration content and against IgniteSamples

[esconner]

Hi, - I can apply the change you suggested. Do you generally prefer if and switch expressions when possible in Ignite? - While I’m at it: do you prefer implicit returns too? If so I could also change my escapedHTML function in line 40. - I’ll also run swiftlint to clear up some whitespace issues I caused (sorry). - did you retract this comment from GitHub? I can’t see it there. Cheers Eric

…

On 4. Apr 2026, at 16:26, Skwiggs ***@***.***> wrote: > + let code = escapedHTML(codeBlock.code) + if let language = codeBlock.language { - #"<pre><code class="language-\#(language.lowercased())">\#(codeBlock.code)</code></pre>"# + return #"<pre><code class="language-\#(language.lowercased())">\#(code)</code></pre>"# } else { - #"<pre><code>\#(codeBlock.code)</code></pre>"# + return #"<pre><code>\#(code)</code></pre>"# ⬇️ Suggested change - let code = escapedHTML(codeBlock.code) - - if let language = codeBlock.language { - #"<pre><code class="language-\#(language.lowercased())">\#(codeBlock.code)</code></pre>"# - return #"<pre><code class="language-\#(language.lowercased())">\#(code)</code></pre>"# - } else { - #"<pre><code>\#(codeBlock.code)</code></pre>"# - return #"<pre><code>\#(code)</code></pre>"# + let code = escapedHTML(codeBlock.code) + +return if let language = codeBlock.language { + #"<pre><code class="language-\#(language.lowercased())">\#(code)</code></pre>"# +} else { + #"<pre><code>\#(code)</code></pre>"#