Skip to content

fix(docs): unblock Pages deploy — MDX autolink breaks the Docusaurus build - #611

Merged
gHashTag merged 1 commit into
mainfrom
fix/docs-mdx-autolink
Aug 8, 2026
Merged

fix(docs): unblock Pages deploy — MDX autolink breaks the Docusaurus build#611
gHashTag merged 1 commit into
mainfrom
fix/docs-mdx-autolink

Conversation

@gHashTag

@gHashTag gHashTag commented Aug 8, 2026

Copy link
Copy Markdown
Owner

Problem

Deploy Website + Docs to GitHub Pages is failing on main (every run — 05:57, 07:06, …), so the site is not publishing at all. Pages Health Check fails as a consequence.

Root cause

The Docusaurus build aborts on the first MDX error:

Error: MDX compilation failed for file
  docs/docs/research/papers/ARXIV_SUBMISSION_CONFIRMATION.md
Cause: Unexpected character `/` (U+002F) before local name, expected a character
       that can start a name, such as a letter, `$`, or `_`
  line 62, column 41 · micromark-extension-mdx-jsx · unexpected-character

Line 62 used the markdown autolink form:

follow the standard procedure at <https://info.arxiv.org/help/submit/index.html>

MDX v3 parses <https… as the start of a JSX tag and chokes on the / in //. Plain Markdown allows this; MDX does not.

Fix

Replaced it with an ordinary markdown link. Verified by grep that this was the only occurrence of the <https://…> autolink pattern anywhere under docs/docs, so this should be the only instance of this class of failure.

follow the standard procedure at [info.arxiv.org/help/submit](https://info.arxiv.org/help/submit/index.html)

Scope

One line, documentation only — no code, no behaviour change. The other CI failures on this repo (e.g. zig build author-guard reporting "no build.zig file found") are pre-existing on main and unrelated to this change.

🤖 Generated with Claude Code

"Deploy Website + Docs to GitHub Pages" has been failing on main: the Docusaurus
build aborts on the first MDX error, so nothing publishes at all.

Root cause: ARXIV_SUBMISSION_CONFIRMATION.md:62 uses the markdown autolink form
<https://info.arxiv.org/help/submit/index.html>. MDX v3 reads `<https...` as a
JSX tag and fails on the `/` in `//`:

  Unexpected character `/` (U+002F) before local name ...
  (micromark-extension-mdx-jsx, unexpected-character)

Replaced with a normal markdown link. This was the only occurrence in docs/docs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@gHashTag
gHashTag merged commit dbca201 into main Aug 8, 2026
13 of 28 checks passed
@gHashTag
gHashTag deleted the fix/docs-mdx-autolink branch August 8, 2026 07:46
github-actions Bot added a commit that referenced this pull request Aug 8, 2026
…olink (#611)

"Deploy Website + Docs to GitHub Pages" has been failing on main: the Docusaurus
build aborts on the first MDX error, so nothing publishes at all.

Root cause: ARXIV_SUBMISSION_CONFIRMATION.md:62 uses the markdown autolink form
<https://info.arxiv.org/help/submit/index.html>. MDX v3 reads `<https...` as a
JSX tag and fails on the `/` in `//`:

  Unexpected character `/` (U+002F) before local name ...
  (micromark-extension-mdx-jsx, unexpected-character)

Replaced with a normal markdown link. This was the only occurrence in docs/docs.

Co-authored-by: Dmitrii Vasilev <admin@t27.dev>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
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