[BUG]
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
Summary
Claude Code's terminal ignores the display text in standard Markdown hyperlink syntax [display text](url) and always renders the full URL as the link text. This causes long file:// paths to wrap across lines, breaking the clickable link.
Expected Behavior
When Claude outputs a Markdown hyperlink such as:
[example.md](file:///C:/code/SDP/impl-docs/sec-7584/le/example.md)
The terminal should render the short display text (example.md) as the clickable link label, with the full URL as the href — exactly as standard Markdown specifies.
Actual Behavior
The terminal ignores the display text and renders the full URL directly as the link text:
file:///C:/code/SDP/impl-docs/sec-7584/le/example.md
When the terminal window is narrower than the URL length, the URL wraps mid-path, breaking the clickable link entirely.
Impact
Long file paths (common in deeply nested project structures) always break on narrower terminals
No workaround exists — Claude cannot shorten the displayed URL behind a display label
Users must keep their terminal wide enough to fit the full path, or manually copy/paste the path
Proposed Solution
Render [display text](url) hyperlinks using the display text as the visible label, with the full URL accessible on click or hover — consistent with how every other Markdown renderer (GitHub, VS Code preview, browsers) handles this syntax.
This would allow Claude to output short, readable file links like:
example.md
database.py
Instead of the full raw URLs that wrap and break.
Environment
Platform: Windows 11
Claude Code version: CLI / Desktop App
Terminal: Windsurf / VS Code integrated terminal
What Should Happen?
Expected Behavior
When Claude outputs a Markdown hyperlink such as:
[example.md](file:///C:/code/SDP/impl-docs/sec-7584/le/example.md)
The terminal should render the short display text (example.md) as the clickable link label, with the full URL as the href — exactly as standard Markdown specifies.
Actual Behavior
The terminal ignores the display text and renders the full URL directly as the link text:
file:///C:/code/SDP/impl-docs/sec-7584/le/example.md
When the terminal window is narrower than the URL length, the URL wraps mid-path, breaking the clickable link entirely.
Error Messages/Logs
Steps to Reproduce
Have claude terminal produce a link to a long "file://" you know of and display a link to that file. If you have a narrow window the link will break because terminal doesn't honor href name and always displays the full URL as the name.
Claude Model
Sonnet (default)
Is this a regression?
No, this never worked
Last Working Version
_No response_
Claude Code Version
2.1.112 (Claude Code)
Platform
Other
Operating System
Windows
Terminal/Shell
Windows Terminal
Additional Information
_No response_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗