Skip to content

fix: convert HTML comments to MDX syntax for future.v4 compatibility - #75

Open
bcdady wants to merge 1 commit into
mainfrom
fix/future-v4-mdx-truncate-syntax
Open

fix: convert HTML comments to MDX syntax for future.v4 compatibility#75
bcdady wants to merge 1 commit into
mainfrom
fix/future-v4-mdx-truncate-syntax

Conversation

@bcdady

@bcdady bcdady commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Fixes #74

Error: MDX compilation failed for file "..."

Changes

  • Converted the blog truncate markers and one freeform HTML comment to {/* ... */} JSX-comment syntax in:
    • src/pages/About_me.md
    • blog/2024/more-links.md
    • blog/2024/welcome.md
    • blog/2025/clifton-strengths.md
  • Updated AGENTS.md's blog-post convention to document {/* truncate */} as required (matches the fix already applied in the sibling ride-more-org repo).

Validation

  • aube run build now completes successfully (previously failed with MDX compilation errors on all 4 files above).

Co-Authored-By: Oz oz-agent@warp.dev

With future.v4 enabled in docusaurus.config.ts, the MDX loader no
breaking the production build:

  Error: MDX compilation failed for file "..."
  character that can start a name ... (note: to create a comment in
  MDX, use `{/* text */}`)

Convert all raw HTML comments (blog truncate markers plus one
freeform comment) to {/* ... */} JSX-comment syntax, and update
AGENTS.md's blog-post convention to match. Verified with a clean
'aube run build'.

Fixes #74

Co-Authored-By: Oz <oz-agent@warp.dev>
Signed-off-by: Bryan Dady <bryan@dady.us>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying bryandady-com with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6672ef3
Status:🚫  Build failed.

View logs

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.

Docusaurus future.v4 breaks legacy <!-- truncate --> (and other HTML-comment) MDX syntax

1 participant