[BUG] Markdown hyperlinks (blue) are unreadable on dark terminal backgrounds

Resolved 💬 3 comments Opened Mar 13, 2026 by halitince7 Closed Mar 17, 2026

Environment

  • Claude Code version: latest
  • OS: macOS (Darwin 25.2.0)
  • Terminal: default (dark background)

Description

When Claude Code outputs markdown-formatted hyperlinks (e.g. GitHub URLs, release links), they render as blue text. On dark/black terminal backgrounds, this blue color has very low contrast and is practically unreadable.

Steps to Reproduce

  1. Use a terminal with a dark background (common default)
  2. Ask Claude Code to create a GitHub release or any task that outputs URLs
  3. The URLs appear as blue text on dark background — nearly invisible

Expected Behavior

Links should be rendered in a color that has sufficient contrast on both light and dark terminal backgrounds. Options:

  • Use the terminal's default link/underline styling (ANSI)
  • Use a brighter blue or cyan that is readable on dark backgrounds
  • Respect the user's terminal theme colors

Actual Behavior

Blue hyperlinks are rendered with low contrast against dark backgrounds, making them unreadable.

Workaround

Currently the only workaround is asking Claude to output URLs as inline code (backticks) instead of markdown links.

Related

  • #1302 — Custom terminal themes (broader request)

View original on GitHub ↗

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