Skip to content

Fix MDX parsing errors in CodeBlock components#140

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/fix-codeblock-parsing-1776039265
Open

Fix MDX parsing errors in CodeBlock components#140
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/fix-codeblock-parsing-1776039265

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 13, 2026

Summary

Two MDX files failed mint validate and mint broken-links due to acorn parsing errors. The <CodeBlock> component is not a standard Mintlify component, and when TypeScript/JavaScript code containing curly braces {} was placed inside it, MDX interpreted the braces as JSX expressions, causing parse failures.

Broken links found

File Error Root cause Fix
developers/developer-guides/integrating-initia-apps/initiadex.mdx Could not parse expression with acorn at line 52:5 <CodeBlock> component containing TS code with {} braces parsed as JSX expressions Replaced all <CodeBlock> components with standard fenced code blocks
developers/developer-guides/vm-specific-tutorials/movevm/creating-move-coin.mdx Could not parse expression with acorn at line 43:5 Same issue — <CodeBlock> with TS code containing {} Replaced all <CodeBlock> components with standard fenced code blocks

Both files were also flagged as warnings in mint validate since the parsing errors made them invisible to the build:

  • "developers/developer-guides/vm-specific-tutorials/movevm/creating-move-coin" is referenced in the docs.json navigation but the file does not exist.
  • "developers/developer-guides/integrating-initia-apps/initiadex" is referenced in the docs.json navigation but the file does not exist.

What changed

Converted all <CodeBlock filename="X" language="Y"> components to standard Mintlify fenced code blocks (```Y X) inside <CodeGroup> wrappers. This is the documented Mintlify pattern for code groups and avoids MDX/JSX expression parsing issues.

Validation

Both mint validate and mint broken-links pass after these changes.

…code blocks

The <CodeBlock> component is not a standard Mintlify component and caused
acorn parsing errors when code contained curly braces (interpreted as JSX
expressions). Converted all <CodeBlock> instances to standard fenced code
blocks inside <CodeGroup> wrappers.

Files fixed:
- developers/developer-guides/integrating-initia-apps/initiadex.mdx
- developers/developer-guides/vm-specific-tutorials/movevm/creating-move-coin.mdx

Generated-By: mintlify-agent
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 13, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
initia-docs 🟢 Ready View Preview Apr 13, 2026, 12:19 AM

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.

0 participants