🐛 Bug: Documentation Style Guide Page – Unresponsive Layout and Hidden Text in Dark Mode

[Utkarsh-123github]

Describe the bug

The documentation style guide page is not responsive on smaller screens, causing layout issues. Additionally, some text elements are not visible when dark mode is enabled, likely due to insufficient color contrast.

Steps To Reproduce

1. Go to https://json-schema.org/md-style-guide
2. Scroll to https://json-schema.org/md-style-guide#summary-and-details you'll find text visibility issue in example part.
3. Inspect page in smaller devices, you'll find unresponsive layout.

Expected Behavior

• The style guide page should be fully responsive and display correctly across all screen sizes, including mobile devices.
• All text and UI elements should remain visible and legible in both light and dark modes, with appropriate color contrast.

Screenshots

Please unmute the video to get a better understanding about the issue.

2025-07-05.14-43-16.mp4

Device Information [optional]

- OS: Ubuntu 24.04.1 LTS
- Browser: Chrome
- version:

Are you working on this issue?

Yes

Do you think this work might require an [Architectural Decision Record (ADR)]? (significant or noteworthy)

No

[Utkarsh-123github]

Hi @benjagm , please have a look over this issue at your convenience. If it aligns with the current priorities and gets approved, I would be glad to work on it.
Thank You !

[idanidan29]

Hi @Utkarsh-123github, i hope you doing well. I raised the same issue a few days ago in #1752. I believe it should be addressed as part of the ongoing GSoC project, during the refactoring of the StyledMarkdown component.

[Utkarsh-123github]

Hi @idanidan29
I think😅, I missed your original issue and ended up creating a duplicate by mistake, I’ll go ahead and close mine.
Also, could you please include the unresponsiveness part as well in your issue so that everything is covered in one place?

Also a small suggestion, please wait for this PR #1760 to get merged than pick this up to avoid any merge conflicts.

Thanks!

[idanidan29]

Sure, I’ll add the unresponsiveness part to the issue, and thanks for the suggestion I’ll wait for it to be merged