Skip to content

Fix broken release table rendering - #58

Merged
sawenzel merged 1 commit into
mainfrom
fix/release-table-render
Aug 3, 2026
Merged

Fix broken release table rendering#58
sawenzel merged 1 commit into
mainfrom
fix/release-table-render

Conversation

@sawenzel

@sawenzel sawenzel commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

The release table in docs/mc-software-releases/README.md (merged in #57) renders as literal |-text instead of an HTML table on the live site.

Root cause: kramdown treats <!-- ... --> as an HTML block that swallows everything up to the next blank line. The table markers I added in #57 had no blank line before the table, so kramdown absorbed the entire table into that block. GitHub's own markdown renderer is lenient about this (the PR preview looked fine), kramdown is not.

Fix: blank line on both sides of <!-- release-table:start/end -->. Verified locally with kramdown before/after (table now produces a real <table> element).

kramdown treats <!-- ... --> as an HTML block that swallows everything up
to the next blank line. The table immediately followed
release-table:start with no blank line, so kramdown absorbed the whole
table into that block and rendered it as literal | text instead of an
HTML table (GitHub's own renderer is lenient about this and did not
catch it before merge; kramdown, the site's actual renderer, is not).
Verified against a local kramdown render of the live page before/after.
@sawenzel
sawenzel merged commit 8b5d64d into main Aug 3, 2026
1 check failed
@sawenzel
sawenzel deleted the fix/release-table-render branch August 3, 2026 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant