Skip to content

docs: restore GFM table rendering in MDX pages#396

Merged
rhuanbarreto merged 1 commit into
mainfrom
fix/docs-table-rendering
Jun 7, 2026
Merged

docs: restore GFM table rendering in MDX pages#396
rhuanbarreto merged 1 commit into
mainfrom
fix/docs-table-rendering

Conversation

@rhuanbarreto

Copy link
Copy Markdown
Contributor

Summary

  • Astro 5+/6 dropped remark-gfm from MDX processing by default, causing all markdown tables across the docs site to render as raw pipe-delimited text instead of proper <table> HTML
  • Added remark-gfm as a direct dependency and enabled it via markdown: { remarkPlugins: [remarkGfm] } in astro.config.mjs
  • Fixes broken tables on 98 MDX pages across all 3 locales (en, pt-br, nb)

Test plan

  • bun run build in docs/ succeeds — both tables on /getting-started/installation/ produce <table> elements in the output HTML
  • Verified all 3 locale variants (/, /pt-br/, /nb/) render 2 tables each
  • bun run validate passes (lint, typecheck, format, ADR check, knip, build)

Astro 5+/6 removed remark-gfm from MDX processing by default,
causing markdown tables to render as raw pipe-delimited text
across all 98 MDX pages that use tables. Add remark-gfm as a
direct dependency and enable it in the Astro markdown config.

Signed-off-by: Rhuan Barreto <rhuan@barreto.work>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying archgate-cli with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1088394
Status: ✅  Deploy successful!
Preview URL: https://ddcebaed.archgate-cli.pages.dev
Branch Preview URL: https://fix-docs-table-rendering.archgate-cli.pages.dev

View logs

@github-actions

github-actions Bot commented Jun 7, 2026

Copy link
Copy Markdown
Contributor

Code Coverage

Metric Value
Lines 90.1% (6786 / 7531)
Threshold 90% minimum — met
Platforms Linux + Windows

Full HTML report available in workflow artifacts.

Per-directory breakdown
Directory Coverage Lines
src/commands/ 88.1% 2078 / 2359
src/engine/ 93.1% 1379 / 1481
src/formats/ 100.0% 141 / 141
src/helpers/ 89.8% 3188 / 3550

@rhuanbarreto rhuanbarreto changed the title fix(docs): restore GFM table rendering in MDX pages docs: restore GFM table rendering in MDX pages Jun 7, 2026
@rhuanbarreto rhuanbarreto merged commit 2345daf into main Jun 7, 2026
26 checks passed
@rhuanbarreto rhuanbarreto deleted the fix/docs-table-rendering branch June 7, 2026 19:51
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