Skip to content

fix: resolve MDX values in Markdown exports - #718

Merged
abernier merged 2 commits into
codex/next-fragment-renderingfrom
codex/next-markdown-exports
Oct 13, 2026
Merged

abernier merged 2 commits into
codex/next-fragment-renderingfrom
codex/next-markdown-exports

Conversation

@abernier

@abernier abernier commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

Summary

Markdown exports currently expose unresolved MDX expressions such as {spacing['4'].value}. Resolve expressions and configured components through the Next application so Copy Page, /<page>.md, and llms-full.txt return the same rendered Markdown, including values inside tables, links, and commands.

Preserve literal code and fence metadata, expose static representations of built-in components, and support markdownComponents overrides for interactive components. Sources remain unchanged; unresolved expressions fail with document context. Markdown route handlers use the same Next builder as the website and HTML fragments; React stream serialization happens inside those handlers.

Stack

Pre-merge review

Generated Entries links now include BASE_PATH, matching authored links and website navigation. Regression tests cover a configured, empty, and absent prefix, preserve group filtering, and check that authored links are not prefixed twice.

Validation

  • pnpm run LGTM on 343f8cfc: typecheck, lint/format, registry validation, 681 passing unit/integration tests (4 skipped), and all 120 Playwright tests passed.
  • Coverage includes scope evaluation, async components, Markdown overrides, literal code and metadata, image URLs, and equivalent page/aggregate exports without source changes.
  • Full documentation Next production export: 50 pages generated. Targeted Copy Page/View as Markdown Playwright test: 2 passed, desktop and mobile viewports, headless Chrome for Testing.
  • An additional fresh CLI consumer-website smoke build could not complete because Next failed to download Inter and Inconsolata from Google Fonts. The full repository production export and browser checks above completed successfully.
  • Existing lint warning in VersionSwitcher.tsx remains; no lint errors.

@abernier
abernier added this pull request to stack #719 October 13, 2026 16:09
@abernier
abernier force-pushed the codex/next-markdown-exports branch from 072321c to 343f8cf Compare October 13, 2026 16:13
@abernier
abernier marked this pull request as ready for review October 13, 2026 16:17
@abernier
abernier merged commit b9c179b into main Oct 13, 2026
5 checks passed
@pmndrs-release pmndrs-release Bot mentioned this pull request Oct 13, 2026

This branch was successfully deployed

1 active deployment
Preview — 343f8cfc Deployed Oct 13, 2026 by abernier via main-job #1254
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