Troubleshooting

MDX components show as text#

Confirm that you use a JavaScript-capable IDE, that dependencies are installed, and that the framework development server starts successfully. Check the documentation profile and route in Documentation and MDX. A Markdown-style fallback is expected when a real site preview is unavailable.

Links resolve to the wrong place#

Check the documentation root, selected framework profile, front-matter slug or permalink, and aliases. Site-root routes and file-relative links use different bases. Refresh after changing navigation configuration.

A table does not render as a table#

Check the chosen flavor. CommonMark and Standard Markdown leave pipe tables as text; GFM and Markdown Extra support them with different handling of escaped pipes and code spans.

Preview text is too large or copying looks wrong#

Reset preview size with Cmd/Ctrl 0 while it has focus. Check size persistence and choose a preview copy format suitable for the receiving application.

Report an issue#

Use email support and include:

• Your IDE edition and full build number from Help → About.
• The installed plugin version; this manual covers 2026.2.8.
• Relevant external-tool versions, the failing action, and a small reproducible example.
• The error message and relevant log excerpt, with credentials and private project data removed.

Use Help → Show Log in Finder/Explorer to locate IDE logs when requested. Describe what you expected to happen and whether the same operation works from a terminal.