[BUG]

Resolved 💬 2 comments Opened Apr 17, 2026 by bruceholmstead-cwan Closed Apr 17, 2026

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_

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗